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The  Movement  Planning 
Module,  LADEN,  has  been  developed  to  provide  an  automated  capability  to 
specifically  load  and  to  determine  the  movement  asset  requirements  In  support 
of  the  movement  of  personnel,  materiel  (both  bulk  and  Individual  Items)  and 
units.  This  module  produces  as  output  movement  asset  requirements  by  movement 
data,  mode,  origin  and  destination  combinations  and  detailed  listings  of  what  ! 
Is  loaded  on  each  convoy,  plane  or  train.  In  addition,  this  loading  program 
can  be  used  to  generate  the  Initial  load  preferences  for  the  TRANATAK 
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SECTION  1 

GENERAL  DESCRIPTION 


The  Department  of  the  Army  Movements  Management  System  Movements  Planning 
Module  (DAMMS-MPM)  has  been  developed  to  provide  the  transportation  planner  with 
an  analytical  tool  which  can  be  used  to  generate  information  on  movement  require¬ 
ments.  The  objectives  of  OAMMS-MPM  are  generally  threefold;  1)  reduce  the  volume 
of  manual  transportation  data  manipulation  and  reports  generation  through 
automation:  2)  to  provide  the  capability  of  developing  detailed  transportation 
feasibility  of  wartime,  contingency  and  peacetime  exercise  programs  under  varying 
conditions,  and  3)  test  the  sensitivity  of  .arying  impacts  on  the  transportation 
system  (e.g..  battle  losses  to  transportation  assets,  changing  tactical 
situations). 

The  Load  Plan  Automation  in  a  DAMMS  Environment  (LADEN)  program  has  been 
designed  to  identify  and  react  to  three  types  of  movement:  unit, 
overweight/outsized  and  all  other.  The  unit  move  assumes  that  a  particular 
military  organization  needs  to  move  as  an  integral  set  of  people,  equipment  and 
other  materiel.  This  type  of  movement  normally  will  not  support  optimization  of 
loading  and  suboptimization  must  be  accepted  in  the  name  of  operational 
expediency.  Overweight/outsized  equipment  requires  unique  loading  because  of  its 
specific  dimensional  and  weight  restrictions;  therefore  it  is  treated 
separately.  Finally,  the  all-other  category  includes  bulk  supply  items  and 
nonunit  personnel  which  can  be  processed  in  a  less  restrictive  manner. 

LADEN  accepts  aS  input  the  movement  requirements.  It  determines,  based 
upon  analyst  generated  priorities,  preferred  mode,  and  the  available  types  of 
cargo  carriers.  It  further  determines  the  required  mix  of  cargo  carriers 
organized  into  air,  barge,  rail,  military  wheeled  and  civilian  wheeled 
movements.  The  numbers  of  vehicles  that  constitute  a  convoy  or  the  length  and 
weight  of  a  train  are  analyst  controlled  as  are  the  cube  and  weight  limitations 
associated  with  a  particular  cargo  carrier. 

There  is  basically  no  restriction  on  the  number  of  items  or  the  number  of 
classes  of  supply  that  can  be  handled  by  LADEN.  Additionally,  there  is  no 


restriction  on  the  number  of  movement  days  or  combinations  of  origin  and  destina¬ 
tion  pairs  that  can  be  processed. 

LADEN  has  been  designed  and  developed  for  stand  alone  operation  although 
In  some  cases  It  requires  access  to  sizeable  standard  equipment  description  lists 
and  TOE  organizational  equipment  lists.  The  program  has  been  structured  to 
support  two  separate  and  distinct  applications  -  to  support  the  USAREUR  Wartime 
Movements  Program,  as  well  as  other  planning  functions,  and  to  provide  Initial 
load  preference  listings  In  support  of  the  TRANATAK  simulation  model.  Separate 
reports  are  generated  for  each  application. 

Section  2  outlines  Input  data  requirements.  Section  3  describes  the 
output  data  and  explains  the  data  and  Its'  formats.  Section  4  contains  the  design 
description  of  the  model.  Section  5  contains  Information  for  the  programmers  who 
provide  support  to  the  program. 

A  schematic  of  LADEN  Is  shown  In  Figure  1-1. 
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SECTION  2 
INPUT  DATA 


2-1  GENERAL. 

All  models  require  Input  data  which  describe  the  objects  that  are  to  be 
represented  In  the  model  and  how  they  are  to  be  represented.  The  objects  that  are 
represented  In  LADEN  are  the  transportation  modes,  the  specific  cargo  carriers  and 
their  capacities  and  dimensions  and  of  course  the  materials  and  people  to  be 
moved.  Additional  Information  Is  required  Identifying  the  required  movement  date, 
the  or'jin  and  destination  of  each  movement  and  what  constitutes  a  complete  convoy 
or  train. 

Items  requiring  movement  are  either  Individually  Identified  with  their 
dimensions  and  weight  or  are  listed  by  supply  class.  In  all  cases  a  preferred 
transportation  mode  (air,  barge,  rail,  military  wheeled,  civilian  wheeled)  must  be 
specified.  Adherence  to  program  quantity  and  dimension  specifications  Is  required 
for  proper  results. 

2-2  PREPARATION  OF  INPUT  DATA. 

The  preparation  of  input  data  for  the  loading  program  Is  a  demanding  but 
not  a  complex  effort.  It  Involves  validating  existing  data,  collecting  or 
generating  and  Integrating  new  data,  and  checking  the  accuracy  of  all  data 
elements  prior  to  executing  the  model. 

2-2.1  Review  of  Existing  Data  File. 


Prior  to  Inputing  data  Into  the  computer  for  a  specific  application.  It 
Is  recommended  that  the  existing  Input  data  files  be  reviewed  to  determine  their 
applicability  to  the  current  application.  This  review,  even  If  It  Identifies 
areas  that  require  major  modification  or  change,  can  significantly  reduce  the  time 
required  to  prepare  a  new  application.  During  this  review  process  the  values  of 
accepted  data  should  be  Independently  verified  as  still  being  valid  or  appropriate 
to  the  specific  application  under  development.  Often  data  values  which  were 


formerly  acceptable  have  changed  or  a  range  of  values  exist  and  for  the  previous 
application  one  value  was  appropriate  whereas  another  value  might  be  preferred  for 
the  new  application. 

2-2.2  Preparation  of  Worksheets. 

If  new  files  or  new  data  are  required,  it  is  recommended  that  the  analyst 
prepare  appropriate  work  sheets  to  document  the  development  of  his  data.  In  LADEN 
there  are  several  interrelated  files  which  may  prove  to  be  more  difficult  to 
develop  independently  than  if  they  are  created  in  an  integrated  manner.  Once  the 
data  have  been  developed,  the  work  sheets  become  the  basis  for  the  preparation  of 
input  cards  or  inputting  the  data  through  an  interactive  terminal.  Preparation  of 
these  work  sheets  are  described  in  connection  with  development  of  each  type  of 
input  data,  where  applicable. 

2-2.3  Coding  Input  Data. 

All  input  data  should  be  coded  according  to  specific  instructions  in  an 
IBM  FORTRAN  Coding  Form  or  a  comparable  form.  The  completed  forms  are  then 
converted  to  input  cards  or  are  used  to  load  the  data  directly  into  the  computer. 
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INSTRUCTIONS  FOR  PREPARATION  OF  WORK  SHEETS. 


2-3.1  Movement  Requirements. 

The  bulk  of  the  input  preparation  effort  involved  in  any  new  application 
will  be  the  development  of  the  movement  requirements.  Figure  2-1  is  a  sample  of  a 
form  used  by  USAREUR  in  preparation  of  its  Wartime  Movements  Program.  The  types 
of  data  contained  on  this  form  are  of  two  categories:  those  which  are  needed  to 
support  LADEN  and  those  which  are  required  solely  for  administrative  purposes. 
The  arrows  superimposed  on  this  figure  indicate  data  required  for  the  loading 
program.  The  associated  numbers  correlate  to  the  input  data  card  description 
described  in  paragraphs  2-3. 1.1  and  2-3. 1.2  and  the  sample  data  shown  in  Figures 
2-2  and  2-3.  Although  Figures  2-2  and  Figure  2-3  contain  most  of  the  data  entered 
on  the  original  worksheet  (Figure  2-1),  many  of  the  items  are  informational  only 
and  merely  are  recorded  for  purposes  of  preparing  the  appropriate  output;  they  do 
not  influence  the  operation  of  the  model.  To  input  data  for  a  specific  movement 
requirement  one  REQl  card  or  data  elements  and  as  many  REQ2  cards  or  data 
combinations  are  required  as  there  are  separate  entries  under  the  commodity 
heading  (see  column  9  of  Figure  2-1).  Explanatory  descriptions  of  the  contents  of 
the  REQl  and  REQ2  cards  are  contained  in  the  following  subparagraphs. 
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NWmEMT  REQUEST 


INSMSIV 


iNaNaivi.* 


2-3. 1.1  REQl  Card  (Movement  Request).  The  REQl  Card  is  designed  to  contain 
elements  of  the  movement  which  are  common  to  the  movement  and  are  not  item 
peculiar.  This  means  that  only  one  REQl  card  is  required  for  each  supporting 
movement  request  form.  This  significantly  reduces  the  preparation  work  required 
of  the  analyst  and  reduces  the  storage  space  required  in  the  computer.  The 
specific  identity,  field  and  description  for  each  entry  are  shown  below. 


Columns 


Entry  Description 


REQl  (Name  of  type  card  used  by  the 
computer  to  create  appropriate  files) 
Blank 

Alert  Stage  (Information  Item) 

Blank 

Required  Movement  day  (starting  day 
for  shipments  In  primary  alert  stage) 
Blank 

Frequency  of  movement  of  this  type  If 
there  are  multiple  Identical  ship¬ 
ments.  Basis  for  repetition,  e.g.,  ID 
*  Dally,  2D  »  Every  2nd  Day,  3D  » 
Every  3d  Day 
Blank 

Number  of  shipments  If  there  are  mul¬ 
tiple  shipments  (e.g.,  01  *  one  ship¬ 
ment,  14  =  fourteen  shipments 
Blank 

Unprogrammed  Movement  Indicator  (in¬ 
formation  Item) 


28  Blank 

29-32  A4  Line  number  for  this  specific  request. 

Numbers  are  sequential  beginning  with 
1  and  are  used  for  program  management 
and  later  identification  not  for  load 
sequencing. 


33 

Blank 

34-41 

A8 

Shipper  grid  coordinates 

42 

Blank 

43-50 

A8 

Shipper  transshipment  location  grid 
coordinates  if  transshipment  is 
required  (railhead,  airfield,  barge 
dock,  etc.). 

51 

Blank 

52-59 

A8 

Receiver  grid  coordinates 

60 

Blank 

61-68 

A8 

Receiver  arrival  location  grid  coor¬ 
dinates  if  transshipment  is  required. 

69 

Blank 

70 

I 

Mode  (1  »  air,  2  =  barge,  3  *  rail,  4 
»  military  wheeled,  5  »  civilian 
wheeled) 

71 

Blank 

72 

I 

Priority  of  shipment  (not  currently 
used) 

73 

Blank 

74-76 

13 

Date  available  to  load  (information 
item  which  is  same  as  columns  17-19 
(movement  day)  above. 

77 

Blank 

78-80 

13 

Required  Delivery  Day  (RDD) /unload 

(information  item) 
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2-3. 1.2  REQ2  Card  (Movement  Request).  The  REQ2  Card  is  designed  to  contain  the 
elements  of  information  required  to  enable  the  computer  to  identify  the  individual 
item  to  be  loaded,  to  classify  it,  dimension  it,  if  required,  and  to  properly  load 
it  on  an  appropriate  cargo  carrier  for  the  specified  mode.  The  specific  identity, 
field  and  description  for  each  entry  are  shown  below. 
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Columns 


Entrv  Descnotion 


REQ2  (Name  of  type  card  used  by  the 
computer  to  create  appropriate  files) 
Blank 

Class  of  Item  of  supply  (use  following 
conversion  table) 

Class  I  dry  »  11 
Class  I  chill  =  12 
Class  II  *  20* 

Class  III  Package  *  31 
Class  III  Diesel  Fuel  »  32 
Class  III  MOGAS  >  33 
Class  III  JP4  >  34 
Class  III  AVGAS  »  35 
Class  IV  »  40* 

Class  V  »  50* 

Class  VI  -  60* 

Class  VII  »  70* 

Class  VIII  »  80* 

Class  IX  =  90* 

Personnel  Replacements  »  100* 

Unit  Moves  *  110* 

NEO  w/bags  *  120* 

Reinforcements  »  130* 


Columns 


Field 


Entry  Description 

12  I  Load  types 

1  *  Unit  moves  (Class  VII  or  PAX) 

2  -  Oversize/outsize,  all  vehicles 
included  in  load  plan,  any  materiel 
the  shipper  identifies  as  a  loading 
problem  because  of  weight  or  dimen¬ 
sion. 

3  »  All  other  moves 

13-14  Blank 

-  If  not  a  unit  move  - 

15-20  A6  LIN  (A  six-character  alphanumeric 

identification  of  a  generic  nomencla¬ 
ture).  An  entry  is  required  if  this 
is  not  a  bulk  class  movement  and  if  a 
model  number  is  required  in  output. 
If  not  a  bulk  movement  and  a  model 
number  is  not  required  in  output  and 
dimensions  and  weight  are  provided, 
the  LIN  is  not  required. 

21  Blank 

22-23  12  Index  number  which  further  delineates 

the  specific  variation  of  the  generic 
item  defined  by  the  LIN. 

-  If  unit  move  - 

15-23  A9  SRC,  if  unit  move.  The  units  listed 

here  must  also  be  on  the  supporting 
SCR  unit  list  which  has  been  developed 
especially  for  this  loading  pro¬ 
gram.**  If  a  matching  SRC  is  not 
available  but  its  subordinate  type 
units  are  on  the  tape,  the  unit  can  be 
unrolled  and  separate  movement  cards 
can  be  input  for  each  subordinate  unit 
to  be  moved.  Alternatively,  the 


Columns 


24-27 

28 


29 

30-32 

33-34 

35-41 


Field  Entry  Description 

equipment  and  personnel  can  be  indi¬ 
vidually  listed  by  type  on  REQ2  cards 
as  for  any  other  type  movement.  In 
any  event,  the  personnel  for  this 
movement  must  be  added  as  a  separate 
entry  as  the  supporting  type  contains 
only  major  items  of  equipment.  If  the 
unit  is  to  be  moved  with  its  basic 
load  of  ammo,  fuel,  rations,  etc., 
then  these  must  be  entered  on  separate 
REQ2  cards. 

Blank 

I  Organization  level  (ALO)  Authorized 

Level  of  Organization  if  unit  move 
{information  item) 

Blank 

13  Total  number  of  items/PAX  requested 

(0-999) 

Blank 

G7.0  Total  weight  in  metric  tons.***  If  a 

quantity  >  1  is  contained  in  columns 
30-32,  this  is  total  weight  for  a 
single  item  of  this  type.  If  this  is 
a  bulk  item  and  only  cube  and  class  is 
known,  the  program  will  use  standard 
factors  to  convert  to  metric  tons.  If 
item  is  bulk  POL,  quantity  is  in 
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Entry  Description 


1,000's  of  gallons,  which  the  program 
will  convert  to  MTONS  using  standard 
conversion  factors. 

Blank 

Total  cube  in  cubic  meters.****  If  a 
quantity  >  1  is  contained  in  columns 
30-32,  this  is  the  total  cube  for  a 
single  item  of  this  type.  If  this  is 
a  bulk  item  and  only  weight  and  class 
is  known  the  program  will  use  standard 
factors  to  convert  the  total  weight  to 
cubic  meters.  If  item  is  bulk  POL,  no 
entry  is  required. 

Blank 

Length  (in  meters).****  If  bulk  item, 
no  entry  is  made. 

Blank 

Width  (in  meters).****  If  bulk  item, 
no  entry  is  made. 

Blank 

Height  (in  meters).****  If  bulk  item, 
no  entry  is  made. 

Blank 

Stackable.  This  entry  indicates 
whether  other  items  can  be  stacked  on 
this  item  and  whether  this  item  can  be 
stacked  on  other  items.  Enter  "1"  to 
indicate  stackable.  Enter  "0"  or 
leave  blank  for  non-stackable. 


Columns 


Field 


Entry  Description 

79  Blank 

80  AI  End  of  order  indicator.  Enter  non¬ 

blank  on  the  last  REQ2  card  for  each 
set  of  Requirement  1,  2  cards.  All 
others  should  be  blank. 


FOOTNOTES: 

♦These  classes  can  also  be  subcategorized,  e.g.,  class  70  could  be  represented  by 
71  *  tanks  and  other  large,  heavy  vehicles;  72  »  other  tracked  vehicles;  73  = 
wheeled  vehicles;  74  »  other  class  VII  items.  To  do  this  corresponding  load 
preferences  must  be  included  in  the  load  preference  table  (paragraph  3-3.3). 

**A  listing  of  these  units  and  the  supporting  file  is  available  by  contacting 
USALOGCEN  ATTN:  ATCL-OPT. 

♦♦♦For  items  which  have  unique  dimensions  and  are  to  be  individually  loaded  the 
dimensions  including  item  cube  do  not  have  to  be  indicated  as  long  as  the  LIN 
(Line  Identification  Number)  is  recorded  in  column  15-20  and  the  supporting 
equipment  data  tape  contains  the  required  LIN  and  information. 

♦♦♦♦For  items  which  have  unique  dimensions  and  are  to  be  individually  loaded 
dimensions  including  item  cube  do  not  have  to  be  indicated  as  long  as  the  LIN  is 
recorded  in  column  15-20  and  the  supporting  equipment  data  tape  contains  the 
required  LIN  and  information. 
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2-3.2  VEHl  Card  (Vehicle  Dimensions). 


The  VEHl  Card  is  designed  to  contain  the  elements  of  information  required 
to  enable  the  computer  to  determine  the  exact  load  dimensions,  capacities  and  door 
restrictions,  if  any.  The  specific  identity,  field  and  description  for  each  entry 
is  shown  below.  An  example  worksheet  is  shown  in  Figure  2-4. 


Columns 


Entry  Description 


VEHl  (Name  of  card  type  used  by  the 
computer  to  create  the  appropriate 
file) 

Blank 

Vehicle  sequence  number  (0-99). 

Sequence  numbers 

1-20  are  allocated  to  air; 

21-40  are  allocated  to  barge; 

41-60  are  allocated  to  rail; 

61-80  are  allocated  to  military 
wheeled;  and 

81-99  are  allocated  to  civilian 
wheeled. 

Blank 

Vehicle  name  (i.e.»  descriptive  nomen¬ 
clature,  model  type,  etc.)  for  later 
information  only. 

Blank 

Empty  vehicle  weight  (MTONS) 

Blank 

Maximum  load  capacity  (MTONS  or  1000' s 
gallons  if  tanker) 

Blank 

Total  vehicle  length  (in  meters) 

Blank 

Vehicle  cargo  length  (in  meters) 

Blank 

Vehicle  cargo  width  (in  meters) 

Blank 

Vehicle  cargo  height  (in  meters) 

Blank 

Passenger  capacity  (0-999) 
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2-3.3  LOOP  Card  (Load  Preference). 


The  Load  Preference  File  Is  a  tvno-card  record  used  to  Identify  loading 
preferences  for  different  type  vehicles.  A  description  of  Figure  2-5  and  2-5.1 
follows. 

The  LOOP  File  allows  the  computer  to  select,  by  order  of  preference, 
vehicles  within  the  specific  modes,  for  a  particular  type  cargo.  The  class  of 
supply  listed  on  the  REQ2  card  (Col  7-9  para  2-3. 1.2)  Is  shown  In  Column  7-9 
Figure  2-5.  The  vehicle  modes  sequence  numbers  and  associated  column  numbers  are 
specified  In  Column  11-80  and  10-48  above.  The  vehicle  types  to  be  used  within  a 
mode  are  Input  with  the  Vehicle  1  card  (Figure  2-4).  In  Figure  2-5  and  2-5.1,  the 
Intersection  of  columns  11-80  and  10-48  (each  possibly  representing  a  vehicle 
type)  and  the  lines  (on  which  the  supply  classes  11,  12,  -  130  are  entered)  pro¬ 
vide  a  block  In  which  to  record  up  to  5  vehicle  type  preferences  within  each 
mode.  In  Figure  2-5,  placing  the  Integer  1  In  the  block  formed  by  the  Intersec¬ 
tion  of  column  11  and  the  line  on  which  supply  class  31  Is  located  Indicates  that 
the  user  prefers  to  use  C-130  aircraft  to  transport  package  POL  when  he  uses  the 
air  mode.  A  2  placed  In  the  block  formed  by  the  Intersection  of  colunnn  52  and  the 
line  of  supply  class  70  Indicates  the  user's  second  choice  for  transporting  class 
VII  by  rail  mode  Is  the  KLS  railcar.  The  loading  program  will  select  the  number 
one  preference  In  every  case  unless  the  cargo  Is  not  compatible  with  the  vehicle 
size.  When  a  piece  of  cargo  Is  too  large  for  a  vehicle,  the  number  two  preferred 
vehicle  for  that  class  of  supply  within  a  mode,  will  be  selected  up  to  the  #5  pre¬ 
ferred  vehicle.  If  none  of  the  five  preferred  vehicles  will  accommodate  the 
cargo,  an  error  will  be  Indicated.  An  example,  the  LOOP  Input  data  Is  shown  at 
Figure  2-5. 
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Figure  2-5.  Sample  LOOP. 


Field 

Entry  Description 

1-4 

A4 

LOOP 

5-6 

Blank 

7-9 

13 

Vehicle  Type 

10 

Blank 

11-80 

6011 

Air  Mode,  Vehicle  #  1-20: 

Use  columns  11 -30^ 

Water  Mode,  Vehicle  #  21-40^^ 
Use  columns  31-50 

Rail  Mode,  Vehicle  #  41-60*** 
Use  columns  51-80 

1-9 

Blank 

10-48 

5911 

Mil.  HHY,  Vehicle  #  61-80**** 

Use  columns  10-29 

Civ.  HWY,  Vehicle  #  81-99***** 

Use  columns  30-48 

♦Example:  Col  11  ■  C130  A/C,  Col  12  -  C141  A/C  etc.  up  to  20  type  A/C 

♦♦Example:  Col  31  *  630  Ton  Barge,  Col  32  ■  500  Ton  Barge  etc.  up  to  20  type 
Barges 

♦♦♦Example:  Col  51  =  GBS  Railcar,  Col  52  »  KLS  Railcar  etc.  up  to  20  type  Rail- 
cars 

♦♦♦♦Example:  Col  10  »  2.5T  Trk,  Col  11  »  5T  Trk  etc.  up  to  20  type  mil  Trk 

♦♦♦♦♦Example:  Col  30  »  LKW  lOT  Trk,  Col  31  ■  Satte/ZUG  (Heavy  lift  Host  Nation 
Trk)  etc.  up  to  20  type  Civ  Trk 
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2-3.4  LODI  Card  (Load  Plan). 


aM 


One  of  the  requirements  associated  with  the  USAREUR  Wartime  movements 
program  is  to  provide  information  to  the  German  Railway  authorities  as  to  the 
specific  load  characteristics.  To  formalize  this  process  the  authorities  have 
developed  and  USAREUR  uses  a  so  called  “ordinal  number."  Each  of  these  ordinal 
numbers  has  a  specific  combination  of  load  and  type  railcar.  In  order  to  provide 
this  same  capability  with  the  loading  routine  a  description  of  these  type  loads  is 
input  and  prior  to  outputting  the  results  of  the  loading  routine  this  list  is 
scanned  for  matches  between  actual  planned  loads  and  ordinal  number  type  loads. 
It  is  possible  to  have  more  than  one  combination  of  loads  and  carriers  with  the 
same  ordinal  number.  The  data  contained  in  this  file  is  shown  below.  An  example 
data  form  is  at  Figure  2-6. 
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NT 


Columns 


Field  Entry  Description 


1-4  A4 


5-8 

9-14  A6 


15 

16-17  12 


18-21 

22-33  A12 

34-35 

36  I 

37-39 

40-51  A12 

52-54 

55  I 

56-58 

59-70  A12 

71-72 

73  I 

74 


LODI  (Name  of  card  type  used  by  the 
computer  to  create  the  appropriate 
file) 

Blank 

LIN  number  (A  six-character  alphanu¬ 
meric  identification  of  a  generic 
nomenclature  -  model  number  will  not 
suffice).  The  same  LIN  numbers  used 
in  REQ2  Cards  should  also  be  here  if 
an  ordinal  number  load  is  appropriate. 
Blank 

Index  number  which  further  delineates 
the  specific  variation  of  the  generic 
item  defined  by  the  LIN  number. 

Blank 

Vehicle  type  -  must  correspond  to 
vehicle  types  defined  in  VEHl  card. 
Blank 

Quantity  of  this  LIN  that  can  be 
loaded  on  this  vehicle  type. 

Blank 

Vehicle  type  -  must  correspond  to 
vehicle  types  defined  in  Vehl  card. 
Blank 

Quantity  of  this  LIN  that  can  be 

loaded  on  this  vehicle  type. 

Blank 

Vehicle  type  -  must  correspond  to 
vehicle  types  defined  in  VEHl  card. 
Blank 

Quantity  of  this  LIN  that  can  be 

loaded  on  this  vehicle  type. 

Blank 
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Columns 


75-80 


Field  Entry  Description 

F6.1 


Ordinal  number  -  a  specific  number 
developed  for  use  with  the  German 
Railway  System  to  identify  type  loads. 


2-3.5  LOCI  (Physical  Location  Information). 


The  LOCI  (Physical  Location  Information)  data  card  is  designed  to  contain 
information  which  will  permit  translation  of  grid  coordinates  into  a  simplified 
numeric  location  code.  This  simplified  code  makes  computer  processing  and  trans¬ 
fer  of  information  easier.  The  specific  code  used  is  based  upon  the  DAMSEL  (Data 
Management  and  Selection)  system.  The  specific  identity,  field  and  description 
for  each  entry  is  shown  below.  An  example  worksheet  is  shown  in  Figure  2-7. 


1-4 

A4 

LOCI  (Name  of  card  type  used  by  the 

computers  to  create  the  appropriate 

file). 

5-6 

Blank 

7-9 

13 

DAMSEL  location  sequence  number 

10 

Blank 

11-50 

A40 

Location  name 

51-54 

Blank 

55-62 

A8 

Location  of  UTM  Grid  coordinates 

2-3.6  SRCFIL  (SRC  File). 


The  SRC  File  is  designed  to  contain  information  on  the  overs i zed/outs i zed 
equipment  authorized  a  TOE  unit.  Use  of  this  file  in  movements  planning  reduces 
the  amount  of  data  required  as  analyst  input.  This  file  contains  the  SRC  number 
followed  by  a  roll-up  of  equipment  by  LIN  and  the  quantity  authorized  at  Level 
1.  The  format  used  is  the  same  as  the  file  produced  from  a  (FORSCON)  Computerized 
Movement  Planning  and  Status  System  (COMPASS)  for  organizations,  and  TRADOC  Master 
TOE  or  Modification  Table  of  Organization  and  Equipment  File  (MTOE)  for  equipment. 


2-3.7  EQPFIC  (Equipment  Characteristic  File). 

The  Equipment  Characteristic  File  is  an  especially  designed  fi^'j  of 
selected  data  extracted  from  the  Army's  central  equipment  characteristic  file. 
This  data  includes  the  LIN  including  index  number,  equipment  dimensions  (length, 
width,  height,  weight  and  cube)  and  model  number.  The  specific  identity,  field 
and  description  for  each  entry  is  shown  below. 


Columns 


Entry  Description 


Equipment  item  LIN  number  (6 
characters),  blank  and  index  number 
(2  characters). 

Blank 

Equipment  item  length  in  inches. 
Blank 

Equipment  item  width  in  inches. 
Blank 

Equipment  item  height  in  inches. 
Blank 

Equipment  item  weight  in  pounds. 
Blank 

Equipment  item  cube  in  cubic  inches 
Blank 

Equipment  item  model  number. 


SECTION  3 
REPORTS 

3-1  GENERAL. 

In  order  to  satisfy  the  reports  requirements  for  the  USAREUR  Wartime 
Movements  Program  and  other  similar  planning  uses  of  this  loading  program  and  to 
generate  the  necessary  input  files  required  to  support  the  TRANATAK  model,  two 
distinct  report  systems  have  been  designed  into  this  program.  The  choice  of 
outputs  is  designated  by  the  analyst  prior  to  model  execution.  This  choice 
includes  the  capability  to  request  a  combination  of  the  two  report  systems. 

3-2  MOVEMENTS  PROGRAM  FORMATS. 

Two  output  formats  are  produced  for  the  movements  program  application. 
These  include  a  modified  version  of  the  European  Railroad  Systems'  ANMELDELISTE 
and  a  detailed  description  of  each  load  combination  (a  convoy  listing). 

3-2.1  ANMELDELISTE. 

The  primary  report  generated  by  this  model  in  support  of  the  transporta¬ 
tion  planning  function  is  a  modified  version  of  the  European  Railroad  Systems' 
ANMELDELISTE.  An  example  of  the  modified  ANMELDELISTE  output  format  is  shown  in 
Figure  3-1.  The  numbered  columns  in  the  heading  correspond  to  the  ANMELDELISTE 

headings.  Others  have  been  added  to  present  additional  data  which  is  needed  for 

clarity  or  cross  reference.  In  order  to  provide  a  listing  which  provides  the 
transportation  planners  with  specific  requirements  and  eliminates  possible 
redundancies  in  the  number  of  transportation  carriers  used  in  the  loading  process, 
the  requirements  for  each  separate  convoy  are  summarized  in  this  report.  Explicit 
loading  and  cross-referencing  to  the  line  number  provided  on  the  input  REQl  card 
is  provided.  The  specifics  of  the  data  represented  in  this  report  are  discussed 
below: 
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Fl|wt  t-1.  ANMlMUIt  OilpM  FMtml. 


Column 


Alert  Stage 

Convoy  # 


Move  Day 

Mode  (of  transportation) 


Origin,  Destination  and 
Remarks  (column  4  of 
ANMELOELISTE) 

Contents  of  movement 
(column  9  of  ANMELOELISTE) 


Type  vehicle,  quantity  and 
(column  12  -  36  of 
ANMELOELISTE) 


Description 

Copied  from  original  input  (pass  thru 
no  processing). 

Corresponds  to  model  generated  convoy 
number  and  provides  a  means  to 
correlate  this  report  with  convoy 
listing. 

Sequencial  day  of  alert  stage,  that 
first  shipment  is  required. 

A  single  integer  number  for  each 
convoy  identifying  its  mode  (1  *  air, 
2  »  barge,  3  =  rail,  4  =  military 
wheeled,  and  5  -  civilian  wheeled). 

Grid  coordinates  of  origin  and 
destination.  A  line  is  also  provided 
for  alphanumeric  remarks. 

Materiel  description  (model  #  if 
appropriate)  by  class,  ordinal  #,  and 
SRC  if  unit  move.  Also  included  is  a 
summary  showing  the  total  number  of 
passengers/total  number  of  items  and 
net  tons  of  convoy  under  NETTO  T. 

The  type  and  quantity  by  type  is 
entered  for  each  type  carrier 
used  to  make  up  the  convoy.  The  total 
number  of  carriers  of  all  types  is 
also  provided. 


Total  weight  and  length 
(column  38  of  ANMELDELISTE) 


Loading  station 
(column  39,  43,  44  of 
ANMELDELISTE) 


Day  of  Shipment 

(column  45  of  ANMELDELISTE) 

Unloading  Station 
(columns  52,  56  and  57 
of  ANMELDELISTE) 


Day  of  Receipt 

(column  55  of  ANMELDELISTE) 


This  entry  is  provided  for  trains 
only  and  consists  of  the  total  length 
of  the  loaded  train  in  meters  on  the 
top  and  below  that  the  total  weight  of 
the  loaded  train  including  the  rail 
cars. 

Origin  loading  point.  Entry 
only  if  a  railhead,  barge  loading 
dock,  airfield  or  other  transshipment 
point  is  indicated  on  the  REQl  card. 

Shipment  date  from  start  of 
simulation. 

Destination  unloading  point. 

Entry  only  if  a  railhead,  barge 
loading  dock,  airfield  or  other 
transshipment  point  is  indicated  on 
the  REQl  card. 

Receipt  date  from  start  of  simul¬ 
ation.  This  date  is  calculated  to  be 
one  more  than  the  shipment  date. 


Movement  Indicator 


If  report  is  for  a  preprogrammed 
movement,  else  its  blank. 


3-2.2  Convoy  Listing. 


An  example  of  the  convoy  listing  output  format  is  shown  in  Figure  3-2. 
This  report  is  designed  to  provide  a  detailed  representation  convoy  (train)  by 
convoy  (train)  of  the  loads  placed  on  each  element  of  that  convoy  (train). 


Rows 


Columns 


Description 


1 


2  -  to  last  element 


General  information. 

1  Convoy  number 

2  Shipment  date 

3  Origin  of  movement  by  name  and  co¬ 

ordinates. 

4  Destination  of  movement  by  name  and 

coordinates. 

5  Mode  (1  =  air,  2  =  barge,  3  =  rail,  4 

a  military  wheeled,  5  *  civilian 

wheeled.) 

Description  of  carrier 
and  contents. 

1  Element  type  which  equates  to  VEHl 

card  types. 

2  -  to  last  item  Series  of  entries  which  contain  data 

on  the: 

•  LIN  of  item  or  class  if  bulk  or 
personnel 

•  Quantity  of  this  item 

•  Line  number  for  reference  back  to 
the  appropriate  REQl  card. 
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3-3 


TRANATAK  MODEL  INPUT  DATA  AND  REPORTS. 


Two  output  products  are  produced  for  the  TRANATAK  application  of  this 
program.  The  first  is  a  computer  tape  which  contains  the  elements  of  data  input 
to  or  generated  by  this  loading  routine  which  are  also  needed  by  TRANATAK.  The 
second  output  provided  for  this  application  is  a  hard  copy  printout  of  the  infor¬ 
mation  contained  on  the  tape. 


3-3.1  Tape  Format. 


The  tape  will  be  prepared  to  reflect  the  following  two  card  file  format. 
First  Card 


Columns 

Field 

Description 

1-5 

A5 

Card  Name  (SHPMT) 

6-7 

12 

Primary  Card  -  1  entered 

8-10 

3X 

Blank 

11-20 

FIO.O 

Time  of  Shipment  (Input) 

21-24 

4X 

Blank 

25-27 

13 

Origin  Technical  Number  (DAMSEL  Code) 

28-30 

13 

Destination  Terminal  Number  (DAMSEL 
Code) 

31-40 

FIO.O 

Enter  0.0  (Return  Pointer) 

41-47 

17 

Class  Designation  (Input) 

48-50 

13 

Event  Type  Code 

51-60 

FIO.O 

Weight  of  Shipment 

61-70 

FIO.O 

Priority 

71-80 

FIO.O 

Cube  of  Shipment 

Second  Card 


Columns 

Field 

Description 

1-5 

A5 

Card  Name  (SHPMT) 

6-7 

8-30 

12 

Continuation  Card  -  2  entered 
23XUnprogrammed  Movements  Indicator 

31-33 

13 

Required  delivery  date.  Equals  time 
of  shipment  plus  one  day. 

34-39 

16 

Convoy  number 

40 

IX 

Blank 

41 

I 

Item  load  type  (1  =  descrete,  2  * 
bulk) 

42-50 

9X 

Blank 

51-52 

12 

Vehicle  sequence  number  of  type  used 

for  this  load 

53-55 

3X 

Blank 

56-58 

13 

Number  of  vehicles  used  for  this 

shipment 

59-60 

2X 

Blank 

61-62 

12 

First  Alternate  Vehicle  Sequence 

Number 

63 

X 

Blank 

64-65 

12 

Second  Alternate  Vehicle  Sequence 

Number 

66 

X 

Blank 

67-68 

12 

Third  Alternate  Vehicle  Sequence 

Number 

69 

X 

Blank 

70-71 

12 

Fourth  Alternate  Vehicle  Sequence 

Number 

72 

X 

Blank 

73-74 

12 

Fifth  Alternate  Vehicle  Sequence 

Number 

50 


SECTION  4 

MOVEMENT  PLANNING  MODULE 
DESIGN  DESCRIPTION 

4-1  GENERAL. 

This  section  contains  a  psuedo-code  description  of  each  module  of  code  in 
the  loading  program.  The  purpose  of  this  description  is  to  provide  a  less 
technical  source  of  information  on  the  process  being  represented  by  the 

corresponding  computer  code. 

4-2  CONTROL. 

Control  for  the  MPM  Loading  Program  is  contained  in  the  Load  Main  (LOADM) 
program  module.  This  module  calls  the  data  preparation  and  processing  routines, 

begins  execution  of  the  loading  routines  and  calls  the  appropriate  report 

generators . 

Load  Main  (LOADM).  The  Load  Main  Module  is  used  to  define  the  type  of 
loading  conditions  that  exist  for  a  specific  use  of  the  loading  routine. 

Modules  Needed  (MN):  USERIN,  LODFIL,  PERMRQ,  SRTMRQ,  SRTITM,  LODSEQ. 

RPTOUT 

1.  Call  User  Input  routine  which  queries  the  user  concerning  reports, 
trace  instructions  and  array  printouts. 

2.  Call  Load  File  routine  which  loads  all  necessary  input  files. 

3.  Call  Periodic  Movement  Request  routine  which  breaks  out  the  periodic 
movements  of  a  specific  frequency  and  content  to  a  supporting  array. 

4.  Call  Sort  Movement  Requests  routine  which  sorts  all  of  the  movement 
requests  into  a  date  sequenced  array.  This  array  is  further  sequenced  by  orgin 
and  destination,  mode  and  type  of  movement. 


5.  Call  Loading  Sequence  routine  which  selects  the  items  to  load,  adds 
new  transport  capability  as  required,  and  builds  new  convoys  (trains)  by  module  as 
needed . 

6.  If  Loading  Program  reports  are  required,  call  Report  Generator 
routine  to  produce  reports. 

4-3  INPUT  DATA  PROCESSING. 

The  following  routines  are  used  to  review,  develop  and  process  input  data 
for  this  loading  program. 

4-3.1  User  Input  (USERIN)  Routine. 

The  User  Input  routine  is  used  to  review  set  parameter  values,  set  three 
values,  and  set  report  generation  indicators. 

4-3.2  Load  Files  (LODFIL)  Routine. 

The  Load  Files  routine  is  used  to  initialize  conditions  for  loading  files 
and  call  the  appropriate  routines  to  read  files  into  arrays. 

Modules  Needed  (MN):  LODSRC,  LODEQP,  LODWMR,  LODOL,  LODLP,  LODVEH 

1.  Call  Load  SRC  (LODSRC)  routine  to  read  in  files  containing  SRC 
numbers  and  authorized  oversized/outsized  equipment  for  each  unit.  This  file  is 
then  accessed  when  a  unit  move  is  identified  and  only  a  SRC  is  provided.' 

2.  Call  Load  Equipment  (LODEQP)  routine  to  read  in  files  containing  the 
LIN  number,  dimensions  (length,  width,  height,  weight  and  cube)  of  major  items  of 
equipment.  This  file  is  used  to  assist  the  analyst  by  reducing  the  amount  of 
analyst -generated  input  required.  It  also  provides  a  cross  reference  to  the  model 
number  which  is  needed  for  output  reports. 


3.  Call  Load  Wartime  Movement  Requests  (LODWMR)  routine  to  load  the 

wartime  movement  request  file  with  the  individual  movement  requests  and  their 
supporting  materiel  and  personnel  lists. 

4.  Call  Load  DAMSEL  Location  (LODDL)  routine  to  load  the  coded 

numerical  location  file  which  translates  the  place  names  of  origins  and 
destinations  in  the  wartime  movements  requests  to  a  number.  This  number 
simplifies  the  sequencing  of  loading  and  is  needed  for  data  passed  to  TRANATAK. 

5.  Call  Load  Preference  (LODLP)  routine  to  load  the  types  of 
transportation  carriers  by  mode  on  which  each  class  of  supply  can  be  loaded. 
These  types  have  a  preferred  order  as  indicated  by  the  number  assigned  to  the 
appropriate  types. 

6.  Call  Load  Vehicle  Dimension  (LODVEH)  routine  to  load  the  loading 

capacity  and  dimensions  for  each  type  carrier  that  may  be  loaded  for  this 
application  of  the  loading  model. 

7.  Call  Load  LODI  (LODLDl)  routine  to  load  the  vehicle,  LIN  number,  and 
ordinal  number  data. 

8.  Return  to  calling  routine. 

4-3.3  Load  SRC  (LOOSRC)  Routine. 

The  Load  SRC  routine  reads  the  SRC  unit  file  and  creates  a  file  of  SRC 
numbers  corresponding  unit  equipment  LIN  and  the  quantity  of  item  by  LIN. 

Common  Input  (Cl):  SRC/IPTSRC(NSRC$).  ISRCQT(NLIN$),  /SRCS/ 

SRCNUM(NSRC$),  SRCLIN- 
(NLINS) 


File  Input  (FI):  PARAM.PRM 


1.  Open  the  file  and  read  the  SRC  File  for  each  SRC  entry. 

If  valid  number,  continue. 

Otherwise,  report  error,  go  to  5. 

2.  Save  ID  of  highest  level  SRC  of  consolidated  SRC  listing. 

3.  Read  line  numbers  of  equipment 

If  valid  line  number,  copy  quantity,  continue. 

Otherwise,  report  error,  continue. 

4.  Last  line  number  the  SRC? 

If  yes,  continue. 

If  no,  go  to  3. 

5.  Last  SRC  in  file? 

If  yes,  return  to  calling  routine. 

If  no,  go  to  1. 

File  Output  (FO);  SRCFIL 

4-3.4  Load  Equipment  (LOOEQP)  Routine. 

The  Load  Equipment  (LOOEQP)  routine  reads  in  the  especially  constructed 
equipment  characteristic  file.  This  file  provides  a  source  of  dimensional  data 
and  model  numbers  to  be  used  by  the  loading  program. 

Cl:  /EqPCHR/LGEQP(NEqP$),  WDEqP(NEqP$),  HTEqP(NEqP$),  WTEqP(NEqP$) , 
CUEqP(NEqP$),  /EqPCH$/EqPLIN(NEqP$),  MULEqP(NEqP$) 

FI:  PARAM.PRM 

1.  Open  the  file. 

2.  Do  3  for  each  item  of  equipment. 

3.  Read  in  dimensions  (length,  width,  height,  weight  and  cube) 


S6 


4.  Read  In  nnodel  number. 


5.  Last  item. 

If  yes,  return  to  calling  routine. 

If  no,  go  to  2. 

File  Output  (FO):  EQPFIL 

4-3.5  Load  Wartime  Movement  Request  (LODWHR)  Routine. 

The  Load  Wartime  Movement  Request  routine  reads  in  the  wartime  movement 
request  file,  expands  the  unit  movement  requirement  and  checks  for  required 
dimensions  and  model  numbers  of  items. 

FI;  PARAM.FIL,  WMRFIL.PRM,  CARDCT.PRM 

MN:  OMPWMR,  PRESRT 

1.  Do  2  for  each  REQl  card  (I  *  1-999). 

2.  Read  in  data  from  REQl  card. 

3.  Compute  model  movement  data  from  input  alert  stage  and  movement  date 
and  set  movement  data  equal  to  the  computed  date. 

4.  Do  5  for  each  supporting  REQ2  card  (0  »  1-999). 

5.  Read  in  date  for  REQ2  card. 

6.  Read  type  name. 

If  type  name  »  1  (unit  move)  and  first  three  elements  of  model  field 
equal  SRC,  call  Presort  routine  to  expand  the  REQ2  cards  to  include  all  required 
equipment  items. 

Otherwise,  continue. 

7.  If  model  is  not  SRC  and  not  blank  the  item  is  one  that  requires 
unique  loading.  Otherwise,  bulk  load  or  personnel,  go  to  9. 


8.  For  unique  loading  items  check  to  see  that  a11  dimensions  are 
provided,  weight  in  metric  tons,  cube  (calculate  if  individual  dimensions  already 
provided).  If  individual  dimensions  not  provided  get  them  from  the  supporting 
equipment  characteristic  file  and  convert  to  meters,  cubic  meters  and  metric 
tons.  This  is  done  by  calling  Pre-Dimension  routine. 

9.  Last  REQ2  card? 

If  yes,  continue. 

If  no,  go  to  4. 

10.  Last  REQl  card? 

If  yes,  continue. 

If  no,  go  to  1. 

11.  Call  Dump  Wartime  Movements  Request  routine  if  trace  is  indicated. 

12.  Return  to  calling  routine. 

4-3.6  Presort  (PRESRT)  Routine. 

The  Presort  Routine  is  used  to  read  in  the  equipment  for  a  specific  unit 
whose  SRC  is  identified  an  REQ2  card  of  a  unit  movement.  This  eliminates  the 
requirement  for  the  analyst  to  individually  list  these  equipment  items  but  it  does 
require  the  preparation  of  a  supporting  SRC-keyed  unit  equipment  data  file  . 
After  the  equipment  dimensions  are  read  in  from  the  unit  equipment  file,  control 
is. returned  to  routine  LOOWMR  to  process  the  remaining  and  other  materiel  such  as 
basic  load  of  rations,  packaged  class  III,  anmunition,  spare  parts,  etc. 

Cl:  /SRC/IPTSRC(NSRC$),  /SRC$/SRCNUM(NSRC$),  SRCLIN(NLIN$) 

FI:  Unit  Equipment  File,  Equipment  Characteristic  File 

1.  Search  Unit  equipment  file  to  find  matching  SRC. 

If  no  match,  report  no  match,  return  to  calling  routine. 

Otherwise,  continue. 


2.  Do  3  for  each  equipment  type  listed. 

3.  Create  a  REQ2  card  for  each  equipment  type  listed  for  this  unit  to 
Include  LIN  quantity,  set  class  equal  to  70,  type  move  equal  to  one  (unit), 
non Stack able. 

4.  READ  LIN. 

If  LIN  Is  >  0,  call  PREDIM  routine. 

Otherwise,  continue. 

5.  Increment  number  of  Items  (REQ2)  cards  counted  (NITEMS  1). 

6.  Last  equipment  Item? 

If  yes,  and  no  other  REQ2  cards  are  listed  for  this  REQl  card,  set 
end  of  file  Indicator.  Return  to  calling  routine.  Otherwise  return  to  calling 
routine. 

If  no,  go  to  2. 

FO:  MMRFIL.PRM 

4-3.7  Pre-Dimension  (PREDIM)  Routine. 

The  Pre-Dimension  routine  matches  a  given  LIN  with  line  numbers  In  the 
equipment  characteristic  file  In  order  to  get  necessary  data  for  a  line  number 
which  Is; 

-  Part  of  a  unit  move  and  the  equipment  has  been  Identified  from  the  SRC 
unit  line  number  file,  or 

-  A  movement  request  Item  (REQ  2  Card)  without  all  dimensions. 

Model  numbers  are  also  obtained  by  this  routine  for  each  unique  LIN  equipment 
Item. 
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Cl:  /EQPCHR/L6EQP(NEQP$),  WDEQP(NEQP$) .  HTEQP(NEQP$) ,  WTEQP(NEQP$) , 
CUEQP(NEQP$),  /EQPCH$)  EQPLIN(NEqP$) ,  MOLEQP(NEQP$) 

FI:  PARAM.PRM 
SAI:  LIN  of  Item 

1.  Match  LIN  of  Item  to  equipment  characteristics  listing. 

If  no  match,  report  error,  delete  REQ2  card  entry,  go  to  5. 

Otherwise,  continue. 

2.  Read  dimensions  from  REQ2  card. 

If  length,  width,  height  are  provided,  compute  cube,  continue. 
Otherwise,  read  length,  width,  height  and  cube,  convert  to  metric 

and  record. 

3.  Read  weight  entry  from  RE02  card. 

If  >  0,  continue. 

Otherwise,  read  weight  from  file,  convert  to  metric  and  record. 

4.  Read  and  record  model  number. 

5.  Return  to  calling  routine. 

4-3.8  Load  DAMSEL  Location  (LOOOL)  Routine. 

The  Load  DAMSEL  Location  routine  reads  the  DAMSEL  Location  File  (LOCI 
cards)  and  converts  Wartime  Movement  Requests  (REOl)  cards'  origin  and  destination 
(Alpha)  data  to  Integer  DAMSEL  location  numbers. 

FI:  PARAM.PRM,  WMRFIL.PRM,  CARDCT.PRM,  DLFIL.PRM 

1.  Open  omSEL  Location  file  (LOCI). 

2.  Read  In  DAMSEL  location  data. 


3.  Close  file. 


4.  Do  5  for  each  REQl  card  (i  »  1,  NMOVRQ). 

5.  Identify  shipper  and  receiver. 

If  no  entry  in  second  location  for  each  then  no  transshipment  is 
involved  and  shipper  and  receiver  are  in  first  location. 

Otherwise  shipper  and  receiver  identity  are  in  second  location 

respectively. 

6.  Read  DAMSEL  code  to  find  DAMSEL  code  for  indicated  coordinates. 

If  no  match  found,  report  error,  go  to  8. 

Otherwise,  continue. 

7.  Record  shipper  and  receiver  code. 

8.  Last  REQl  card? 

If  yes,  return  to  calling  routine. 

If  no,  go  to  4. 

4-3.9  Load  Preference  (LOOLP)  Routine. 

The  Load  Preference  routine  reads  in  load  preference  file  data  (LOOP) 
cards  to  initialize  the  LODPRF  array  which  is  the  load  preference  table  used 
during  loading. 

FI:  LPFIL.PRM 

1.  Open  LPFIL  file. 

2.  Do  3  for  each  class  (i  *  1,130). 

3.  Read  in  data  on  which  types  of  vehicle  by  mode  that  this  class  of 
supply  prefers  to  be  loaded  upon. 

4.  Last  class? 

If  yes,  continue. 

If  no,  go  to  2. 
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5.  Close  file. 


6.  Return  to  calling  routine. 

CO:  LODPRF  Array. 

4-3.10  Load  Vehicle  Dimensions  (LODVEH)  Routine. 

The  Load  Vehicle  Dimensions  routine  reads  In  vehicle  dimensions  data 
(VEHl  cards)  which  establish  the  load  limits  for  each  type  vehicle  used  for 
loading  purposes  In  this  application  of  the  loading  module. 

FI:  PARAM.PRM,  VEHFIL.PRM,  FILNUM.PRM.  CARDCT.PRM. 

1.  Open  VEHFIL. 

2.  Do  3  for  each  vehicle  type. 

3.  Copy  In  load  data  characteristics  Including  total  weight,  length, 
width,  height,  door  dimensions  and  overall  vehicle  length. 

4.  Compute  and  record  vehicle  loading  cube. 

5.  Last  vehicle  type? 

If  yes,  continue. 

If  no,  go  to  2. 

6.  Close  file. 

7.  Return  to  calling  routine. 


FO:  VEHFIL 


4-3.11  Load  Load  Plan  (LODLOl)  Routine. 


The  Load  Load  Plan  routine  reads  in  type  loads  which  have  been  given  an 
ordinal  load  number  by  type  load.  This  ordinal  number  is  used  in  communicating 
type  load  information  to  the  European  railway  authorities  via  the  output  reports. 

FI;  L01FIL.DAT 

1.  Open  load  plan  file. 

2.  Do  3  for  each  type  load. 

3.  Read  in  data  on  LIN  of  equipment  item,  the  matching  rail  car  type(s) 
which  constitute  an  appropriate  carrier  and  the  assigned  ordinal  number  which 
identifies  this  load. 

4.  Last  load  type? 

If  yes,  return  to  calling  routine. 

If  no,  go  to  2. 

FO:  LOOPLA,  LOOPLI,  ORDNUM 
4-3.12  Periodic  Movement  Request  (PERMRQ)  Routine. 

The  Periodic  Movement  Request  routine  expands  the  wartime  movement 
requests  which  are  periodic  requests  so  that  each  becomes  an  Individual  request  in 
the  expanded  movement  request  array. 

FI;  PARAM.PRM,  CARDCT.PRM,  WMRFIL.PRM 

1.  Do  2  for  each  REQl  (1  »  1,NM0VRQ). 

2.  Check  movement  frequency  and  number  of  movements  of  this  type  on 

REQl  card. 

If  both  are  >  0,  continue. 

Otherwise,  go  to  8. 


3.  If  first  movement,  set  move  day  in  M0VRQ2  equal  to  first  movement 
date,  go  to  6. 


4.  Do  5  for  each  additional  movement. 

5.  Set  movement  date  in  M0VRQ2  equal  to  last  movement  date  plus 
movement  frequency. 

6.  Set  pointer  in  M0VRQ2  back  to  REQl  array  entry. 

7.  Last  movement? 

If  yes,  continue. 

If  no,  go  to  4. 

8.  Last  REQl  card? 

If  yes,  return  to  calling  routine. 

If  no,  go  to  1. 

CO:  M0VRQ2  Array. 

4-3.13  Sort  Movement  Request  (SRTMRQ)  Routine. 

The  Sort  Movement  Requests  routine  sorts  movement  request  data  (REQl 
cards)  by  movement  date,  mode,  move/load  type,  orgin  and  destination.  This 
sorting  occurs  after  LOOFIL  routine  and  before  LODSEQ  routine.  The  procedure  used 
permits  a  column  by  column  walk  through  of  the  movement  data  when  it  is  being 
loaded  and  eliminates  searching  and  sorting  during  the  loading  process. 

FI:  PARAM.PRM,  CARDCT.PRM,  WRMFIL.PRM 

1.  Do  2  for  each  entry  in  expanded  wartime  movement  request  file. 

2.  Search  for  earliest  movement  date  and  find  all  with  that  date. 


3.  Do  4  for  each  of  the  entries  identified  in  2. 


4.  Find  the  smallest  move/load  type  or  priority  load.  Type  loads  in¬ 
clude  1  »  unit,  2  -  oversized/outsized/unique  items  or  3  =  bulk  loads. 

5.  Do  6  for  each  orgin  and  destination  combination. 

6.  Sort  and  group. 

7.  Do  8  for  each  mode. 

8.  Sort  and  group. 

9.  Set  pointers. 

10.  Last  entry  in  expanded  wartime  movements  request  file? 

If  yes,  return  to  calling  routine. 

If  no,  go  to  1. 

4-4  LOADING  SEQUENCE 

The  following  routines  are  used  to  load  a  particular  item  on  an  appro¬ 
priate  carrier  and  to  assemble  convoys  (trains)  which  are  made  up  of  proper  com¬ 
ponents  (elements).  Additionally  these  routines  build  the  arrays  which  provide 
the  data  for  output/postprocessing  reports. 

4-4.1  Load  Sequence  (LODSEQ)  Routine. 

The  Load  Sequence  routine  is  the  control  or  driver  routine  for  the 
loading  process.  It  selects  the  items  to  load,  evaluates  the  type  of  load  it 
represents,  the  type  carrier  on  which  it  is  to  be  loaded,  determines  the  specific 
convoy  and  vehicle  which  appears  to  accommodate  the  load  and  calls  the  central 
loading  routine  to  accomplish  the  loading.  In  some  cases  if  additional  vehicles 
need  to  be  added  to  a  convoy  to  accommodate  the  load  this  routine  adds  the  vehicle 
and  if  new  convoys  are  required  it  creates  them. 


FI:  PARAM.PRM,  CUBDEF.PRM,  CARDCT.PRM,  LODING.PRM,  WMRFIL.PRM,  LPFIL. 

PRM,  VEHFIL.PRM,  NMAXEL.PRM 
MN:  LOGON V 

1.  Build  an  appropriate  convoy  for  a  new  set  of  movement  attribute  load 
and  calls  the  central  loading  routine  to  accomplish  the  loading.  In  some  cases  if 
additional  vehicles  need  to  be  added  to  a  convoy  to  accommodate  the  load  this  rou¬ 
tine  adds  the  vehicle  and  if  new  convoys  are  required  it  creates  them. 

FI:  PARAM.PRM.  CUBDEF.PRM,  CARDCT.PRM,  LODING.PRM,  WMRFIL.PRM,  LPFIL. 

PRM,  VEHFIL.PRM,  NMAXEL.PRM 
MN:  LDCONV 

1.  Build  an  appropriate  convoy  for  a  new  set  of  movement  attributes. 

2.  Establish  data  necessary  for  a  movement  request  to  be  loaded  on  a 

convoy. 

3.  Do  4  for  each  item  listed  for  a  REQl  card,  i.e.,  all  of  the  sup¬ 
porting  REQ2  cards. 

4.  Read  cube  of  item. 

If  cube  equal  zero  and  weight  %  0,  continue. 

If  cube  h  zero,  go  to  6. 

Otherwise,  report  error,  go  to  17. 

5.  Calculate  cube  based  upon  class  conversion  table  and  record. 

6.  Check  to  see  if  item  is  class  VII  or  personnel. 

If  yes,  set  quantity  of  item  to  be  loaded. 

If  no,  initialize  weight  and  cube  to  be  loaded. 

7.  Read  load  preference  table  to  find  preferred  type  of  carrier  for 
this  class  of  item  for  the  specific  mode  to  travel. 
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If  class  VII  item,  see  if  it  will  fit  through  door,  if  any,  and  on 
to  carrier,  continue.  If  will  not  fit  call  Dump  Error  routine,  go  to  17. 

Otherwise,  continue. 

8.  If  this  is  not  class  III  bulk,  check  to  see  if  there  is  an  element 
of  the  type  needed  available  -  if  not  add  one.  Set  convoy  length  and  weight  if 
appropriate  (rail).  Go  to  10. 

9.  If  this  is  not  a  unit  move  and  it  involves  rail  movement  of  class  V 
then  add  appropriate  buffer  vehicles,  if  required,  set  ammo  flag,  set  convoy 
weight  and  length  and  add  first  element  for  loading. 

10.  Call  Load  Convoy  routine. 

11.  Check  quantity  yet  to  be  loaded. 

If  zero,  all  have  been  loaded,  go  to  17. 

Otherwise,  continue. 

12.  Could  not  load  everything  on  identified  element  of  existing  convoys, 
must  add  a  new  element  or  convoy. 

13.  Read  mode. 

If  mode  »  3  (rail),  continue. 

Otherwise,  go  to  16. 

14.  Check  to  see  if  adding  a  new  element  of  the  preferred  type  to  the 
current  convoy  would  exceed  authorized  length. 

If  yes,  index  to  a  new  convoy,  go  to  8. 

If  no,  continue. 

15.  Check  to  see  if  the  weight  of  the  empty  element  plus  a  factor  of  its 
empty  weight  exceeds  the  total  authorized  convoy  weight. 

If  yes,  index  to  a  new  convoy,  go  to  8. 

If  no,  add  empty  weight  to  total  accumulated  weight  and  vehicle 
length  to  total  accumulated  length.  Go  to  8. 


16.  Identify  next  element  to  be  examined  for  loading. 

If  cube  and  weight  permit.  Identify  element  for  possible  load,  go  to 

10. 

Otherwise,  go  to  8. 

17.  Last  Item? 

If  yes,  continue. 

If  no,  go  to  3. 

18.  Last  REQl  card? 

If  yes,  return  to  calling  routine 
If  no,  continue. 

19.  Read  next  movement  (REQl)  entry. 

20.  Determine  whether  date,  origin,  destination,  mode  and  type-move  com¬ 
bination  Is  same  as  last  REQl  entry. 

If  yes,  go  to  2. 

If  no  go  to  1. 

4-4.2  Load  Convoy  (LOCONV)  Routine. 

The  Load  Convoy  routine  Is  used  to  recognize  the  class  of  an  item  to  be 
loaded  c.i  an  Identified  element  and  to  call  the  appropriate  loading  routine. 

FI:  PARAM.PRM,  WMRFIL.PRM 

MN:  LODPOL,  LOADS,  L0A07,  LOADA,  LOADP 

1.  Read  class. 

2.  If  class  ■  32-35  (bulk  POL),  call  Load  POL  routine.  Upon  return, 
return  to  calling  routine. 

3.  If  class  *  other  bulk  Items  (classes  I,  II,  III  (package),  IV,  VI, 
VIII,  IX),  or  class  V  with  unit  moves,  call  Load  Bulk  Routine. 
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4.  If  class  »  VII  (unique  items),  call  Load  Class  Seven  routine.  Upon 
return,  return  to  calling  routine. 

5.  If  class  -  V  (ammo)  and  this  Is  not  a  unit  move,  call  Load  Ammo  rou¬ 
tine.  Upon  return,  return  to  calling  routine. 

6.  If  class  -  10,  12  or  13  (personnel)  call  Load  Personnel  routine. 
Upon  return,  return  to  calling  routine. 

7.  If  any  other  classes  report  error,  return  to  call  routine. 

4-4.3  Load  POL  (LODPOL)  Routine. 

The  Load  POL  routine  loads  bulk  POL  on  appropriate  carriers.  The 
carriers  are  filled  to  capacity,  but  partial  loads  are  loaded.  There  Is  no  mixing 
of  products. 

FI:  POLFIG.PRM,  PARAM.PRM,  LODINS.PRM,  NMAXEL.PRM,  VEHFIL.PRM, 

WMRFIL.PRM 

SAI:  Convoy  number  of  first  appropriate  convoy. 

1.  Read  in  number  gallons  to  be  shipped  and  capacity  of  carrier.  Cal¬ 
culate  number  of  loads.  If  there  Is  a  remainder,  the  convoy  report  reflects  a 
warning. 

2.  If  mode  *  3  (rail)  the  weight  of  the  product  must  be  determined  In 
order  to  add  It  to  the  train  weight.  Product  weights  are  Input  as  variables. 
Otherwise  to  go  10. 

3.  Identify  appropriate  convoys  by  date,  orgin,  destination,  mode. 

4.  Do  5  for  each  convoy  with  these  attributes. 

5.  Is  convoy  complete? 

If  yes,  bypass,  go  to  13. 

Otherwise,  continue. 


6.  Is  convoy  an  aninunitlon  convoy? 

If  yes,  bypass,  go  to  13. 

Otherwise,  continue. 

7.  Check  to  see  if  adding  another  element  of  the  preferred  type  will 
cause  convoy  to  exceed  its  authorized  length. 

If  yes,  bypass,  go  to  13. 

If  no,  continue. 

8.  Check  to  see  if  adding  another  element  of  the  preferred  type  loaded 
with  the  indicated  product  will  cause  the  convoy  to  exceed  its  authorized  weight. 

If  yes,  bypass,  ‘go  to  13. 

If  no,  continue. 

g.  Increment  the  total  length  and  weight  of  the  convoy  by  the  new  ele¬ 
ment,  go  to  11. 

10.  Check  to  see  if  total  quantity  of  elements  that  make  up  convoy  of 
other  modes  are  <_  authorized  quantity  after  adding  this  element. 

If  yes,  continue. 

If  no,  go  to  13. 

11.  All  the  element  to  the  convoy  and  load  it.  Reduce  quantity  of  the 
item  to  be  loaded  by  the  quantity  loaded. 

12.  Check  to  see  if  more  elements  are  needed  to  load  item,  if  yes,  con¬ 
tinue  until  complete.  If  cannot  complete,  continue. 

13.  If  only  one  convoy  type  exists  or  none  can  accept  load  build  a  new 
convoy.  Go  to  4. 

If  more  than  one  convoy  exists,  go  to  14. 

14.  If  other  convoys  exist  with  the  same  attributes,  check  to  see  if 
elements  can  be  added  by  looping  through  other  convoys. 

If  yes,  go  to  4. 

Otherwise,  go  to  13. 


4-4.4  Load  Bulk  (LOAOB)  Routine. 


The  Load  Bulk  routine  loads  bulk  Items  of  classes  I,  II,  III  (package), 
IV,  V  (unit  move),  VI,  VIII,  and  IX  onto  appropriate  transportation  carriers. 

FI:  PARAM.PRM,  L00IN6.PRM,  NMAXEL.PRM,  VEHFIL.PRM,  WRMFIL.PRM 
SAI:  Convoy  Identity  of  convoy  to  be  loaded,  carrier  preferences. 

1.  Do  2  for  each  convoy  with  matching  date,  origin,  destination  and 

mode. 

2.  Is  convoy  complete? 

If  yes,  go  to  14. 

Otherwise,  continue. 

3.  Is  convoy  an  ammunition  convoy? 

If  yes,  go  to  14. 

Otherwise,  continue. 

4.  Do  5  for  each  element  of  this  convoy. 

5.  Check  current  element  to  see  If  full. 

If  full,  go  to  7. 

Otherwise,  continue. 

6.  Check  to  see  If  this  element  Is  a  preferred  carrier  type  (for  bulk 
more  than  one  type  could  be  acceptable). 

7.  Last  element  this  convoy? 

If  yes,  go  to  13. 

If  no,  go  to  4. 

8.  Calculate  remaining  weight  available  on  this  element. 


9.  Read  mode. 

If  mode  =  3  (rail)  then  convoy  is  weight  constrained.  See  if  all  of 
item  weight  can  be  accommodated  within  total  element  and  total  convoy  weight 
constraints.  If  convoy  has  arrived  at  maximum  authorized  weight  close  it  out. 

Otherwise,  go  to  13. 

10.  Calculate  remaining  cube  available  on  element. 

11.  Check  to  see  how  much  of  item  can  be  loaded  in  available  cube  and  if 
necessary  modify  quantity  and  weight  previously  loaded. 

12.  If  all  of  item  loaded,  return  to  calling  routine. 

13.  If  all  of  item  has  not  yet  been  loaded,  check  to  see  if  another 
element  exists  in  this  convoy  and  if  the  item  can  be  loaded  on  this  element.  If 
this  was  last  possible  element,  go  to  14. 

Otherwise,  check  next  element,  go  to  15. 

14.  Check  next  convoy  (if  one  exists). 

If  none  exists,  continue. 

Otherwise,  go  to  2. 

15.  Check  to  see  if  already  searched  all  previous  convoys. 

If  yes,  continue. 

If  no,  go  to  14. 

16.  Build  a  new  convoy  and  add  appropriate  element.  Go  to  1. 

4-4.5  Load  Class  VII  (L0A07)  Routine. 

The  Load  Class  VII  routine  identifies  appropriate  elements  and  convoys 
which  have  the  residual  weight  and  cube  to  load  a  unique  item.  Subroutine  GBL30 
is  called  to  determine  whether  or  not  the  item  can  be  loaded  and  to  do  the  actual 
loading. 


FI:  PARAM.PRM,  L0DIN6.PRM.  NMAXEL.PRM,  VEHFIL.PRM,  WMRFIL.PRM,  CLASS?. 

PRM 

SAI:  Convoy  to  be  searched 

MN:  SETGBL,  LOAD  (entry  points  to  GBL30) 

1.  Do  2  for  identified  convoy. 

2.  Is  convoy  already  complete? 

If  yes,  bypass,  go  to  12. 

Otherwise,  continue. 

3.  Read  mode. 

If  mode  »  3  (rail)  convoy  is  weight  constrained  see  if  one  of  item 
can  be  loaded  on  residua!  weight.  If  yes,  continue.  If  no,  go  to  12. 

If  other  mode,  continue. 

4.  check  to  see  if  ammo-only  convoy. 

If  yes,  bypass,  go  to  12. 

If  no,  continue. 

5.  Check  to  see  if  this  element  is  full. 

If  yes,  go  to  11. 

If  no,  continue. 

6.  Check  remaining  weight  and  cube  on  this  element. 

If  both  2  i^equired  weight  and  cube,  continue. 

Otherwise,  go  to  11. 

7.  Call  SETGBL  routine  to  initialize  entry  point  in  routine  GBL3D. 

8.  Call  CODING  routine  (entry  point  to  routine  GBL3D)  to  try  to  load 

item. 

If  could  not  load  any,  go  to  11. 

Otherwise,  continue. 

9.  If  element  was  filled  by  load,  close  out  element. 


73 


10.  If  loaded  all  or  part,  adjust  element  weight,  cube  and  convoy  total 
weight  (if  rail). 

11.  If  all  not  loaded  check  for  another  element. 

If  last  element,  check  next  convoy.  Continue. 

If  not  last  element  in  this  convoy,  go  to  5. 

12.  Search  previous  convoy  to  see  if  any  can  accommodate  items. 

If  already  searched  prior  convoys  add  element  or  convoy,  return  to 
calling  routine. 

If  only  one  convoy,  return  and  build  new  convoy  for  item,  return  to 
calling  routine. 

4-4.6  Load  Ammunition  (LOAOA)  Routine. 

The  Load  Ammunition  routine  loads  bulk  ammunition  (excludes  ammunition 
moving  with  a  unit)  on  ammunition  only  convoys  by  identifying  appropriate  elements 
and  adds  necessary  buffers. 

FI:  PARAM.PRM,  L0DIN6.PRM,  NMAXEL.PRM,  VEHFIL.PRM,  WMRFIL.PRM 
SAI:  Convoy  number  of  convoy  to  be  loaded,  carrier  preference 

1.  Do  2  for  each  convoy  identified. 

2.  Is  convoy  complete? 

If  yes,  go  to  13. 

Otherwise,  go  to  3. 

3.  Is  convoy  an  ammunition  convoy? 

If  yes,  go  to  4. 

If  no,  go  to  13. 

4.  Check  to  see  if  element  full  or  a  buffer. 

If  yes,  go  to  7. 

Otherwise,  continue. 


5.  Is  this  a  preferred  carrier  type?  NOTE:  Check  to  see  if  this 

If  yes,  go  to  6.  element  is  preferred  carrier 

If  no,  go  to  7.  type  (for  bulk  more  than  one 

type  could  be  acceptable.) 

6.  Check  current  element  to  see  if  full. 

If  full,  go  to  9. 

Otherwise,  go  to  11. 

7.  Last  element  this  convoy? 

If  yes,  go  to  13. 

If  no,  go  to  4. 

8.  Calculate  remaining  weight  available  on  this  element. 

9.  Read  mode. 

If  mode  =  3  (rail)  then  convoy  is  weight  constrained  see  if  all  of 
item  weight  can  be  accommodated  within  total  element  and  total  convoy  weight 
constraints.  If  convoy  has  arrived  at  maximum  authorized  weight  close  it  out  and 
Go  to  12,  otherwise 
Go  to  7. 

10.  Calculate  remaining  cube  available  on  element  and 
Go  to  6. 

11.  Check  to  see  how  much  of  item  can  be  loaded  in  available  cube  and  if 
necessary  modify  quantity  and  weight  previously  loaded.  Go  to  6. 

12.  If  all  of  item  loaded,  return  to  calling  routine. 

13.  If  all  of  item  has  not  yet  been  loaded,  check  to  see  if  another 
element  exists  in  this  convoy  and  if  the  item  can  be  loaded  on  this  element.  If 
this  was  last  possible  element,  go  to  12. 

Otherwise,  check  next  element,  go  to  13. b. 
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13. b  Check  next  convoy  (1f  one  exists). 

If  none  exists,  go  to  12. 

Otherwise,  go  to  4. 

13. c  Check  to  see  if  already  searched  a11  previous  convoys. 

If  yes,  go  to  12. 

If  no,  go  to  13. d. 

13. d  No  new  element  this  convoy,  go  to  12.  New  elements  available,  go  to 

1. 

4-4.7  Load  Personnel  (LOADP). 

The  Load  Personnel  routine  identifies  appropriate  elements  and  convoys 
which  have  the  residual  passenger  capacity  to  load  personnel,  and  load  these  class 
10,  12  and  13  requests. 

FI:  PARAM.PRM,  LOOING.PRM,  NMAXEL.PRM,  VEHFIL.PRM,  WMRFIL.PRM 
SAI:  Convoy  identity  of  convoy  to  be  loaded,  carrier  preference. 

1.  Do  2  for  each  convoy  with  matching  date,  origin,  destination  and 

mode. 

2.  Is  convoy  complete? 

If  yes,  go  to  14., 

Otherwise,  continue. 

3.  Read  mode 

If  mode  =  3  (rail)  see  if  at  least  one  passenger  can  be  accommodated 
within  overall  weight  constraints  of  train.  If  yes,  continue,  if  no,  go  to  14. 
Otherwise,  continue. 

4.  Check  to  see  if  ammo  convoy. 

If  yes,  go  to  14. 

Otherwise,  continue. 

5.  Do  6  for  each  element  in  this  convoy. 


6.  Check  to  see  if  full. 

If  full,  go  to  8. 

Otherwise,  continue. 

7.  Check  to  see  if  this  is  a  preferred  carrier  type. 

If  yes,  to  go  9. 

If  no,  continue. 

8.  Last  element  this  convoy? 

If  yes,  go  to  14. 

If  no,  go  to  5. 

9.  As  total  passenger  capacity  is  controlled  by  quantity,  determine 
remaining  capacity. 

10 .  Check  Mode 

If  mode  »  3  (rail)  check  to  see  if  entire  number  determined  above 
can  be  accommodated  within  the  train  weight  limitations. 

If  yes,  continue. 

If  no,  modify  the  number  loaded  accordingly,  continue. 

If  mode  ^  3  continue. 

11.  Have  all  been  loaded? 

If  yes,  return  to  calling  routine. 

If  no,  continue 

12.  If  all  of  the  item  has  not  been  loaded,  continue  checking  elements 
of  this  convoy. 

If  last  possible  element  go  to  14. 

Otherwise,  continue. 

13.  Check  next  element,  go  to  5. 

14.  Check  through  previous  similar  convoys,  go  to  1. 
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4-4.8  Subroutine  GBL30. 


Subroutine  GBL30  Is  an  adaptation  and  extension  of  an  MTMC  loading 
program  which  has  been  extended  to  consider  three  dimensional  loading  of  unique 
dimensioned  Items.  It  attempts  to  load  a  specific  quantity  of  Items  on  a 
specifically  Identified  carrier  (element). 

FI:  PARAM.PRM,  CLASS?. PRM,  GBLLOC.FOR,  GBLGLBP.PRM,  GBLBLBU.FOR 

1.  Define  vehicle  capacities. 

2.  Set  filled  shadow  to  empty. 

3.  Define  utilization  ratios. 

4.  Set  optimization  choice. 

5.  Define  door  clearances. 

6.  Assign  displacement  values. 

7.  If  there  Is  nothing  to  load,  or  the  Item  won't  fit  through  door, 
return.  Otherwise,  continue. 

8.  Try  all  load  orientations.  Try  stack  first,  then  channel  and 

finally  front  load  space. 

9.  Determine  number  of  Items  that  can  be  loaded  with  current 

orientation. 

10.  If  any  Items  can  be  loaded  assign  new  load  dimensions. 

11.  If  any  Item  can  be  loaded,  assign  new  shadow  and  channel 

dimensions.  Calculate  residual  cube  and  weight,  total  loaded  and  decrement  the 

number  on  hand. 


12.  If  none  can  be  loaded,  reset  dimensions  and  try  alternate 
orientation. 

13.  Save  information  for  report  generation. 

14.  If  the  residual  space  is  less  than  the  slack  determined  by 
utilization  rate,  blank  fill  it. 

15.  Determine  if  space  is  full. 

If  yes,  return  to  calling  routine. 

Otherwise,  update  residual,  return  to  calling  routine. 

4-5  REPORTS. 

As  a  result  of  this  loading  program  being  used  for  multiple  purposes,  the 
report  generation  process  is  extensive.  The  following  routines  are  used  in  this 
process . 

4-5.1  Report  Generator  (RPT6EN)  Routine. 

The  Report  Generator  routine  gathers  convoy,  element  and  item  data  for 
each  movement  and  readies  this  data  to  be  output  on  the  appropriate  report. 

1.  Do  2  for  each  movement. 

2.  Has  this  movement  already  been  examined? 

If  yes,  go  to  9. 

Otherwise,  continue. 

3.  Do  4  for  each  element  type  in  movement. 

4.  Sort  by  date  and  mode  within  date. 

5.  Count  total  elements  by  type  for  each  convoy. 

6.  Sort  items  by  class. 
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7.  Last  type? 

If  yes,  continue. 

If  no,  go  to  3. 

8.  Call  Sort  Items  routine  to  sort  of  items  by  class,  then  match  models 
Mhen  printing  out  to  sum  together  quantities  of  the  same  models. 

9.  Last  movement? 

If  yes,  return  to  calling  routine. 

If  no,  go  to  1. 

4-5.2  Sort  Items  (SRTITX)  Routine. 

The  Sort  Items  (expanded  items,  already  loaded)  routine  sorts  loaded 
items  by  class  and  by  matching  model  numbers  if  any  duplicates  exist  in 
preparation  for  output  on  the  ANMELDELISTE  report  form. 

FI;  ?ARAM.PRM,  L0DIN6.PRM 

1.  Sort  items  by  class. 

2.  Collect  quantities  of  duplicate  models  if  any  exist. 

3.  Return  to  calling  routine. 

4-5.3  Report  ANMELDELISTE  (RPTMIL)  Routine. 

The  Report  ANMELDELISTE  routine  prints  headings  and  appropriate  tabulated 
data  for  the  ANMELDELISTE  load  report  form. 

4-5. 3.1  Provide  for; 

1.  Convoy  number 

2 .  Movement  date 
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4.  Originator 
Destination 
Remarks 

5.  Contents 

6.  Coaches  and  cars 
Type 

Quantity 

Total 

7.  Total  raetars/Total  Tonnage 

8.  Loading  station 

9.  Unloading  station 

10.  Movement  indicator 

4-5. 3. 2  Print  out 


1.  Heading 

2.  Main  body  of  report 

4-5.4  Report  Convoy  Listing  (RPTDET)  Routine. 

The  Report  Convoy  Listing  routine  prints  out  the  detailed  contents  of 
each  convoy  with  pointers  back  to  original  REQl  data.  Print  out  the  following 
information: 


1 .  Convoy  number 


2 .  Date 

3.  Origin 

4.  Destination 

5.  Mode 

6.  For  each  element 

a.  Type  element 

b.  Item  (LIN  or  class)  quantity  and  wartime  movement  line  number 
for  each  item  loaded  on  this  element 


4-5.5  Write  TRANATAK  Tape  (RPTSHP)  Routine. 

The  Write  TRANATAK  Tape  routine  writes  a  tape  which  serves  as  loading 
input  data  for  the  TRANATAK  simulation  model.  In  addition,  this  routine  prints 
out  the  data  contained  on  the  TRANATAK  Tape  for  analyst  review. 

4-5.6  Ordinal  Number  (ORDNO)  Routine. 


The  Ordinal  Number  (ORDNO)  Routine  matches  a  given  LIN  and  vehicle  with 
the  Lead  Plan  (LD1FIL.DAT)  file  and  reports  any  ordinal  number  that  exists  for 
that  load  combination. 

FI;  LD1FIL.DAT 


1.  Match  LIN. 

If  no  match  return. 
If  match,  continue. 


2.  Match  vehicle. 

If  match,  get  ordinal  number. 

3.  Return. 
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4-6  DEBUG  AND  DUMP  ROUTINES. 

In  order  to  asset  the  users  of  this  loading  program  an  extensive  system 
of  debugging  and  dump  routines  have  been  developed  for  this  program.  These 
augment  the  normal  Trace  system  which  is  limited  to  specific  activities  and 
calculations  by  providing  detailed  access  to  the  data  collection,  manipulation  and 
recording  which  makes  up  this  program. 

4-6.1  Dump  Wartime  Movement  Requests  (OMPWMR)  Routine. 

Dump  Wartime  Movement  Requests  (DMPWMR)  Routine.  The  Dump  Wartime 
Movement  Requests  routine  prints  out  the  generated  movement  request  data  arrays. 

FI:  PARAM.PRM,  CARDCT.PRM.  LODING.PRM,  WRMFIL.PRM,  LPFIL.PRM 

1.  Do  2  for  each  REQl  card.  (I  =  l.NMOVRQ) 

2.  Print  out  each  REQl  card. 

3.  Last  REQl  card? 

If  yes,  continue. 

Otherwise,  go  to  1. 

4.  Do  5  for  each  REQ2  card. 

5.  Print  out  each  REQ2  card  (i  =  1,  NITEMS). 

6.  Last  REQ2  card? 

If  yes,  continue. 

If  no,  go  to  4. 

7.  Do  8  for  each  entry  in  expanded  wartime  movements  request  data 
expanded  (i  «  1,  NMVRQX). 

8.  Print  out  each  REQ2  card. 


9.  Last  entry? 

If  yes,  continue. 

If  no,  go  to  7. 

10.  Print  out  loading  variables  from  WRMFIL. 

11.  Return  to  calling  routine. 

4-6.2  Dump  Load  (DHPLOO)  Routine. 

The  Dump  Load  Routine  is  a  debugging  trace  routine  which  prints  the 
contents  of  variables  and  arrays  used  during  the  loading  process. 

FI:  PARAM.PRM,  CARDCT.PRM,  WMiFIL.PRM,  LODING.PRM 

Print  out  selected  variables  and  arrays  including: 

Preferred  carrier  types 
Movement  Request  Data  (Expanded) 

Convoy  data 
Element  data 
Item  data 
Loading  Variables 

4-6.3  Dump  Error  (DMPERR)  Routine. 

The  Dump  Error  routine,  based  upon  an  input  argument,  automatically 
prints  errors  related  to  loading  items  onto  elements  and  indicates  source  of 
error . 

4-6.4  Dump  Class  VII  (0MPCL7)  Routine. 

The  Dump  Class  VII  routine  is  a  debugging  trace  routine  which  prints  the 
contents  of  variables  and  arrays  used  during  the  loading  of  class  VII  items. 


SECTION  5 

USER  AND  PROGRAMMER  GUIDE 


5-1  GENERAL. 

This  section  provides  guidance  for  both  the  user  and  the  programmer  of  the  MPM 
Loading  Program. 

5-2  TERMINOLOGY. 

All  files  and  subroutines  used  in  the  Loading  Program  will  be  referred  to 
using  names  listed  in  Tables  5-1  and  5-2.  These  are  complete  listings  which 
briefly  define  the  content  or  purpose  of  each  entry.  Two  files  should  be  noted. 
The  first  is  the  TOE  organizational  equipment  list  which  is  called  “SRCFIL.DAT" 
because  it  is  used  when  an  SRC  number  is  listed  on  an  REQ2  Card  for  a  unit  move. 
The  second  is  the  standard  equipment  description  list  which  is  called  "EQPFIL.DAT" 
since  it  contains  equipment  data  including  dimensions,  weight,  cube  and  models. 

MN  Modules  Needed 

FI  File  Input 

FO  File  Output 

SAI  Subroutines  Argument  Input 

SAO  Subroutine  Argument  Output 

Cl  Common  Input 

CO  Common  Output 

5-3  USER  GUIDE. 

The  User  Guide  contains  information  necessary  for  beginning  execution  of 
the  Loading  Program  after  all  file  data  has  been  generated  and  is  available  for 
model  use. 

5-3.1  Linking  The  Loading  Program. 

An  executable  image  of  the  Loading  Program  is  created  by  linking  the 
model.  All  of  the  subroutines  listed  in  Table  5-1  must  be  linked  together  in 


order  to  run  the  Loading  Program.  Linking  the  Loading  Program  Is  necessary  If  no 
previous  executable  Image  exists,  or  If  any  subroutines  have  been  recompiled  to 
Incorporate  code  or  parameter  changes.  The  Loading  Program  Is  linked  on  the  VAX 
11/780  by  the  link  command  file  shown  In  Table  5-4  “ LINKLOAD. COM"  by  typing 
'0LINKLOAO  next  to  the  dollar  sign  prompt  during  an  Interactive  terminal 
session.  The  executable  Image  w111  then  exist  under  the  first  module  name 
following  the  LINK  command,  I.e.,  as  L0A0M.EXE  In  the  example  below,  and  the 
Loading  Program  can  then  be  run  by  typing  “RUN  LOADM"  next  to  dollar  sign 
prompt.  Note  that  the  hyphens  shown  below  are  continuation  marks. 


TABLE  5-1.  Loading  Program  Subroutines 


DMCPL?  -  writes  shadow  of  vehicles  for  class  70  through  79  loading  process 

DMPERR  -  writes  data  and  execution  errors 

DMPLOD  -  writes  contents  of  loading  arrays 

DNPUMR  -  writes  contents  of  wartime  movement  request  arrays 

GBL3D  -  load  unique  items  on  identified  vehicles  (class  70  through  79) 

6BLGLBU  -  contains  common  data  for  GBL30 

GBLREP  -  reports  class  70  through  79  loading  process 

LDCONV  -  identifies  class  of  item  to  be  loaded  and  calls  appropriate  loading 

routine 

L0A07  -  initializes  loading  to  unique  items  (class  70  through  79) 

LOAOA  -  loads  non-unit  ammunition  (class  50) 

LOAOB  -  loads  bulk  items  on  appropriate  vehicles  (class  10,  20,  30,  40,  50  as 
unit  60,  80,  and  90) 

LOAOM  -  driver  program 

LOAOP  -  loads  personnel  on  appropriate  vehicles  (class  100,  120,  and  130) 

LOOOL  -  reads  DAMSEL  Location  LOCI  Cards 

LOOEQP  -  reads  specially  formatted  equipment  characteristic  file 

LODFIL  -  calls  appropriate  file  reading  subroutine 

LOOLDl  -  reads  type  loads  with  ordinal  numbers  from  LODI  cards 

LOOLP  -  reads  load  preference  data  from  LOOP  cards 

LOOPOL  -  loads  bulk  POL  onto  appropriate  vehicles  (class  32  through  35) 

LOOSEQ  -  builds  convoys,  selects  items  to  load,  adds  new  vehicles 

LOD^C  -  reads  SRC  unit  file 

LOOVEH  -  reads  vehicle  dimension  data  from  VEHl  cards 

LOOUMR  -  reads  wartime  movement  request  data  from  REQl  and  REQ2  cards 

ORONO  -  matches  LINs  and  vehicle  to  find  ordinal  numbers 

PERNRQ  -  breaks  out  periodic  movement  requests 

PREOIM  -  matches  LIN  with  model  number  and  get  item  dimensions  if  necessary 
PRESRT  -  provides  LIN  numbers  for  an  SRC  unit  move 

RPTDET  -  reports  detailed  contents  of  each  convoy  with  specific  items  on  each 
vehicle 

RPTGEN  -  gathers  convoy,  vehicle,  and  item  data  necessary  for  report 
generation 

RPTMIL  -  produces  ANMELDELISTE  report 

RPTSHP  -  produces  TRANATAK  data  file 

SRTITM  -  sorts  items  by  dimension  for  optimized  loading  (not  completed) 

SRITIX  -  sorts  items  on  a  convoy  by  ascending  class  for  ANMELDELISTE  report 

SRTMRQ  -  sorts  movements  into  loading  order 

USERIN  -  communicates  with  user  on  how  to  run  program,  traces,  and  reports 
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TABLE  5-2.  Loading  Program  Data  Files. 


DLFIL.DAT 

EQPFIL.DAT 

LOAOM.OAT 

LD1FIL.DAT 

LPFIL.DAT 

SHPMT.DAT 

SRCFIL.DAT 

VEHFIL.DAT 

WMRFIL.DAT 


DAMSEL  Location  file,  LOCI  cards 

specially  formatted  equipment  characteristic  file 

post  execution  output  of  traces,  errors,  reports 

type  loads  with  associated  ordinal  numbers,  LODI  cards 

load  preference  file,  LODP  cards 

post  execution  output  of  TR/U\IATAK  data,  SHPMT  cards 

SRC  unit  file 

vehicle  dimension  file,  VEHl  cards 

wartime  movement  request  file,  REQl  and  REQ2  cards 


TABLE  5-3.  Common  Files. 

These  files  are  used  commonly  In  different  subroutines  by  the 
FORTRAN-77  INCLUDE  Statement.  Recompilation  of  the  Subroutine  which  Includes  them 
Is  necessary  If  any  data  In  these  files  Is  changed. 


CARDCT.PRM  -  count  of  Input  data  cards 

DLFIL.PRM  -  damsel  location  data  arrays 

EQPFIL.PRM  -  equipment  characteristic  data  arrays 

6BLGLBP.PRM  -  GBL30  common  data 

LDIFIL.PRM  -  load  plan  data  arrays  for  ordinal  numbers 

LOOING.PRM  -  convoy  loading  process  arrays 

LPFIL.PRM  -  load  preference  arrays 

PARAM.PRM  -  parameters  set  by  user 

VEHFIL.PRM  -  vehicle  dimension  data  arrays 

WMRFIL.PRM  -  wartime  movement  request  data  arrays 


V-v.'. 
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5-3.2  Parameter  Values. 

Parameters  are  used  to  allow  ease  in  changing  the  variables  which  affect 
execution  of  the  Loading  Program.  Establishing  correct  parameter  value  should  be 
done  with  care,  since  many  parameters  values  are  critical  to  optimal  use  of  array 
storage,  used  during  program  execution.  If  a  parameter  value  is  to  small,  it  will 
be  identified  during  a  file  reading  process,  which  will  indicate  the  parameter 
value  needed  to  be  increased.  Compilations  will  take  longer  than  necessary  for 
smaller  array  sizes,  and  execution  will  be  slowed  by  the  use  of  unnecessarily 
large  storage  space  required  for  Loading  Program.  A  listing  of  all  parameters 
used  is  shown  in  Table  5-5  as  represented  in  the  file  PARAM.PRM. 

Array  Boundary  Parameter  Values. 

The  parameters  which  establish  boundaries  for  arrays  used  during  the  loading 
process  should  in  most  cases  be  set  equal  to  the  number  of  cards  or  records  read 
into  the  file  that  the  array  represents.  These  parameters  are  extracted  from 
Table  5-5  and  listed  below. 


NMVRQS 

NITEM$ 

NDMSL$ 

NL001$ 

NVEH1$ 

NEQPS 

NSRC$ 

NLIN$ 


number 

number 

number 

number 

number 

number 

number 

number 


of  REQl  cards  in  file  WMRFIL.DAT 
of  REQ2  cards  in  file  WMRFIL.DAT 
of  LOCI  cards  in  file  DLFIL.DAT 
of  LODI  cards  in  file  LPFIL.DAT 
of  VEHl  cards  in  file  VEHFIL.DAT 
of  LIN  in  file  EQPFIL.DAT 
of  SRC  numbers  in  file  SRCFIL.DAT 
of  LINS  in  file  SRCFIL.DAT 


Changing  Parameter  Values. 


Parameter  values  can  be  changes  only  by  editing  the  file  PARAM.PRM  shown 
in  Table  5-5.  When  the  desired  changes  have  been  incorporated  in  PARAM.PRM,  any 
routines  which  have  the  FORTRAN  statement  "INCLUDE  PARAM.PRM"  must  be  recompiled, 
and  the  Loading  Program  must  then  be  relinked  before  execution. 
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TABLE  5-5.  Parameters  in  PARAM.PRM  File. 

C 

IMPLICIT  INTEGER*2  (I-N) 

C  COMMON/ARACE/KTRACE 

C  NMOVT$  : NUMBER  OF  MOVEMENT/LOAD  TYPES 
C  UNITS  :UNIT  MOVE/LOAD  TYPE 

C  OVERS  rOVERSIZE/OUTSIZE  MOVE/LOAD  TYPE 

C  OTHERS  :ALL  OTHER  MOVE/LOAD  TYPES 

C 

INTEGER  UNITS, OVERS, OTHERS 

PARAMETER  (NM0VTS=3.  UNITS’l,  0VERS=2,  OTHERS=3) 

C 

C  NMOOES  : NUMBER  OF  MODES 

C  AIRS  :AIR  MODE 

C  BARGES  : BARGE  MODE 

C  RAILS  :RAIL  MODE 

C  MILWHS  :MILITARY  WHEELED  MODE 

C  COVWHS  ’.CIVILIAN  WHEELED  MODE 

C 

INTEGER  AI RS , BARGES , RAI LS , M I LWHS , C I VWHS 
PARAMETER  (NMODES=5,  AIRS»1,  BARGES»2,  RAILS=3, 

+  MILWHS=4,  CIVWHS*5) 

C 

C  NBUFS  : NUMBER  OF  BUFFERS  FOR  NON-UNIT  AMMO  CONVOYS 
C  PASWTS  :IN  MTONS 

PARAMETER  (NBUFS-1,  PASWTS0.8) 

C 

C 

C  RRWTS  cMAXIMUM  WEIGHT  ALLOWED  FOR  A  RAIL  CONVOY  IN  MTONS. 

C  RRLGS  :MAXIMUM  LENGTH  ALLOWED  FORA  RAIL  CONVOY  IN  METERS. 

C  RLASTS  :THE  FACTOR  MULTIPLIED  TIMES  AN  ADDITIONAL  EMPTY  CAR 
C  TO  SEE  IF  THE  CAR  CAN  BE  ADDED  WITHIN  CONVOY  WEIGHT  CONSTRAINTS. 

PARAPMETER  (RRWTS  »  1500,  RRLGS  =  500,  RLASTS  =  1.5) 

C 

C  NPREFS: NUMBER  OF  PREFERRED  CARRIER  TYPES  ALLOWED  PER  ITEM 
PARAMETER  (NPREFS  »  5) 

C 

C  NMVRQS:  OR  -  #  REQl  CARDS  READ  IN 
C  NITEMS:>  OR  «  #  OF  REQE  CARDS  READ  IN 

C  NDMSLS:>  OR  >  #  OF  LOCI  CROS  READ  IN 

C  NVEH1S:>  OR  >  #  OF  VEHl  CARDS  READ  IN 

C  NL0D1S:>  OR  -  #  OF  LODI  CARDS  READ  IN  FORM  LOAD  PLAN  FILE. 

C  NEQPS  :  #  OF  MODEL  LINE  NUMBERS  IN  EQUIPMENT  CHARACTERISTIC  FILE 
C  ONLY  LINE  NUMBERS  WITH  INDEXES  ARE  CONTAINED  IN  THIS  FILE, 

C  A  LINE  NUMBER  'W29716A00'  WILL  NOT  OCCUR  IN  THIS  FILE. 

C  NSRCS  :  #  OF  SRC  NUMBERS  IN  UNIT  SRC  TABLE 
C  NLINS  :  #  OF  MODEL  LINE  NUMBERS  IN  UNIT  SRC  TABLE 

C  NAVSHS:  AVERAGE  #  OF  SHIPMENTS  FOR  REQl  CARDS,  USED  TO  SET 

C  ARRAY  BOUNDARIES  FOR  THE  EXPNDED  REQl  ARRAYS,  ALLOWS  ROOM 


ooooo  ooooooo  oooorjo  ooooooo  ooo  oooo  oooooo 


TABLE  5-5.  Parameters  in  PARAM.PRM  File.  (Cont'd) 

FOR  PERIODIC  MOVEMENTS.  ROUTINE  WILL  STOP  EXECUTION  AND 
GIVE  ERROR  MESSAGE  IS  NAVSH$  IS  NOT  LARGE  ENOUGH  TO 
ACCOMODATE  PERIODIC  SHIPMENTS  IN  WARTIME  MOVEMENT  REQUESTS. 
NAVSH$*NMVRQ$  SETS  THE  ARRAY  BOUNDARIES  FOR  THE  EXAPNDED 
MOVEMENT  ARRAYS 

PARAMETER  (NMVRQ$  =  20,  NITEM$  =  500, 

+  NDMSLS  =  100,  NHVEIS  =  100,  NEQP$=200,  NL0D1$=50, 

+  NSRC$=50,  NLIN$*500,  NAVSH$  =  3) 

NC0N$  :  >  OR  =  NCON,  ARRAY  LIMITS  FOR  CONVOY  ARRAYS 
NELE$  :>  OR  =  NELE,  ARRAY  LIMITS  FOR  ELEMENT  ARRAYS 
NITMXS  :>  OR  =  NITEMX,  ARRALY  LIMITS  FOR  EXPANDED  FEM  ARRAYS 
PARAMETER  (NC0N$=100,  NELE$=700,  NITMX$=8D0) 

LPR0W$  :  #  OF  ROWS  IN  LOAD  PREFERENCE  FILE  CALLED  LPFIL. 

LPCOLS  :  #  OF  COLUMNS  IN  LOAD  PREFERENCE  FILE  'LPFIL' 

PARAMETER  (LPR0W$  -  130,  LPCOLS  =  99) 

CUSS7  -  LDEFINE  UTILIZATION  OF  ITEM  LOADNG  RATIOS, 

FULL  UTILIZATION  IS  1.0,  AN  AVERAGE  UTILIZATION  IS  0.7 
THRLGS  :USER  DEFINED  LENGTH  UTILIZATION  RATIO. 

THRWDS  :USER  DEFINED  WIDTH  UTILIZATION  RATIO. 

THRSTS  ;USER  DEFINED  STACK  UTILIZATION  RATIO. 

PARAMETER  (THRGS*  0.7,  THRWDS  -  0.7,  THRSTS  -  0.7) 

CLASS  7  LOADING  -  DEFINE  DOOR  CLEARANCES,  FLUSH  FIT  OF  ITEM  IS  0.0  : 
CLRLGS  :  USER  DEFINED  DOOR  LENGTH  CLEARANCE  MINIMUM. 

CLRWOS  :  USER  DEFINED  DOOR  WIDTH  CLEARANCE  MINIMUM. 

CLRSTS  :  USER  DEFINED  DOOR  STACK  CLEARANCE  MINIMUM. 

PARAMETER  (CLRLGS  -  0.0,  CLRWOS  -  0.0,  CLRSTS  *0.0) 

POL  FIGURES  BELOW  REPRESENT  WEIGHT  OF  LOAD  (MTONS) 

P0L32S  ;  CLASS  32,  DIESEL,  1  M3=.840  MTONS 

P0L33S  :  CLASS  33,  MO  GAS,  1  M3=.744  MTONS 

P0L34S  :  CLASS  34,  JP4,  1  M3=.794  MTONS 

P0L35S  :  CLASS  35,  AVN  GAS,  1  M3».721  MTONS 

PARAMETER  (P0L32S  »  50.8, 

+  P0L33S  -  45.0, 

+  P0L34S  -48.0, 

+  P0L35S  »  43.6) 


COMMON/OPTPC/  CONTAINS  LOADING  OPTIMIZIATION  WEIGHT  AND  CUBE 
PERCENTAGES  WHICH  MUST  BE  ACHEIVEO  BEFORE  A  CONVOY  (ROW  1)  OR  ELEMENT 
(R0W2)  CAN  BE  CLOSED  OUT  AS  FULL.  THESE  ARE  INITIALIZED  BY  MODE  IN  DATA 
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TABLE  5-5.  Parameter  in  PARAM.PRM  File  (Cont'd) 

C  STATEMENT  BELOW.  OPTWTS  CONTAINS  PERCENTAGES  FOR  WEIGHT,  AND  OPTCUS 
C  CONTAINS  PERCENTAGES  FOR  CUBE. 

C 

COMMON  /OPTPC/OPTWTS ( 2 . NMODES ) . OPTCUS ( 2 . NMODES ) 

DATA  OPTWTSd.AIRS),  OPTWT${2,AIR$)  /  .90,  .90  / 

DATA  OPTCUS (1, AIRS),  0PTCUS(2,AIRS)  /  .90,  .90  / 

DATA  0PTWTS(1,BARGES),0PTWTS(2, BARGES)/  .90,  .90  / 
DATA  0PTCUS(1,BARGES),0PTCUS(2,BARGES)/  .90,  .90  / 
DATA  0PTWTS(1,RAILS),  OPTWTS (2, RAILS)  /  .90,  .90  / 
DATA  OPTCUS (1, RAILS),  OPTCUS (2, RAILS)  /  .90,  .90  / 
DATA  0PTWTS(1,MILWHS),0PTWTS{2,MILWHS)/  .90,  .90  / 
DATA  0PTCUS(1,MILWHS),0PTCUS(2,MILWHS)/  .90,  .90  / 

DATA  0PTWTS(1,CIVWHS),0PTWTS{2,CIVWH4)/  .90,  .90  / 

DATA  0PTCUS(1,CIVWHS),0PTCUS(2,CIVWHS)/  .90,  .90  / 

C 

C  ALERT  STAGE  PARAMETERS: 

C  VSRG  >  MOVEMENT  DAY 
C  (V)SRG  «  MOVEMENT  DAY  +  VS 

C  (VS)RG  >  MOVEMENT  DAY  •••  VS  SS 

C  (VSR)G  -  MOVEMENT  DAY  +  VS  +  SS  +  RS 

INTEGER  VS,  SS,  RS,  GS 

PARAMETER  (VS-3,  SS*3,  RS-3,  GS»11) 

C 

C  NCUSS  :  NUMBER  OF  CLASSES 

C  CUBOEF  :  CUBE  DEFAULT  TABLE.  HOLDS  CONVERSION  FACTORS  FOR  CUBE 
C  TO  MTONS,  ONE  FACTOR  FOR  EACH  CLASS,  CLASS  1  FIRST. 

PARAMETER  (NCLASS>13) 

C0M10N/CUB0EF/CUB0EF ( NCLASS ) 

DATA  CUBDEF  /2.1,2.6,1. 7,2. 1,.9,2.0,2.0,2. 6,2.0, .0,.0..0,.0/ 

C 

C  UNIT  NUMBERS  OF  FILES  NEEDED  BY  THE  LOADING  PROGRAML 
C  WMRFIL  :  WARTIME  MOVEMENT  REQUEST  FILE,  REQl  &  REQ2  CARDS 

C  EQPFIL  :  EQUIPMENT  CHARACTERISTIC  FILE,  SPECIAL  FORMAT  IN  ROUTINE 

C  LOOEQP 

C  OLFIL  :  DAMSEL  LOCATION  FILE,  LOCI  CARDS 

C  LDIFIL  :  LOAD  PLAN  FILE  WITH  ORDINAL  NUMBERS,  LODI  CRADS 

C  LPFIL  ;  LOAD  PREFERENCE  FILE,  LODP  CARDS 

C  VEHFIL  :  VEHICLE  DIMENSION  FILE,  VEHl  CARDS 

C  SRCFIL  :  SRC  FIL,  HAS  SRC  #S  AND  THEIR  LIN  #S 

C  LOADM  :  LOADM.DAT  FILE,  CONTAINS  ALL  OUTPUT  FROM  LOADING  PROGRAM 

C  EXECUTION 

COMMON  /FILNUM/WRMFIL,EQPFIL,DLFIL,LOQFIL,LPFIL, VEHFIL, 
+SRCFIL,LOADM 

INTEGER*2  WMRF I L . EQPF I L , DLF I L . LDIFI L , LPF I L , VEHF I L . SRCFI L , LOADM 
DATA  WMRFIL,EQPFIL,DLFIL,LD1FIL,LPFIL,VEHFIL,SRCFIL,L0ADM 
1  /lO.ll, 12. 13,14,15,16, 17 

CHARACTER  CRDFLD*4 
C 

C  NMAXEL  :  MAXIMUM  NUMBERS  OF  ELEMENTS  ALLOWED  IN  A  CONVOY  BY  MODE: 


TABLE  5-5.  Parameters  in  PARAM.PRM  File.  (Concluded) 


C0M40N  /NMAXEL/  NNAXEL(NN00E$} 

DATA  NMAXEL(AIR$),  NMAXEL(BARGE$) .NMAXEL(RAIL$) , 

-t-  NMAXEL(MILUH$).NMAXEL(CIVWH$) 

1  /  1.  60  ,  0  .  60  .  60  / 

C  ONLY  THE  INTEGER  INSIDE  THE  SLASHES  SHOULD  BE  CHANGED,  AND  NOT  THE 
C  PARAMETER  SUBSCRIPTS. 


5-3.3  FILE  USAGE. 


The  Loading  Program  assumes  that  some  or  all  files  Mill  be  read  from  the 
card  reader  or  exist  on  disk  under  the  names  listed  In  Table  5-2. 

Input  Files  From  Card  Reader. 

COMMON/FI LNUM/  contained  In  file  PARAM.PRM  Is  shown  below  and  contains 
s^ollc  names  for  the  units  each  file  Is  read  from.  An  Initializing  DATA 
statement  assigns  values  to  these  symbolic  names. 

COmON/FILNUM/UNRFIL,EQPFIL.OLFIL,LDlFIL,LPFIL»VEHFIL,SRCFIL,LOADM  INTEGER* 
UMRFIL.EQPFIL.OLFIL.LOIFIL.LPFIL.VEHFIL.SRCFIL.LOADM 
DATA  UMRFIL,EQPFIL.DLFIL.LD1FIL.LPFIL,VEHFIL.SRCFIL.L0ADM 
/10,11,12,13,14.15,16.17/ 

Input  files  can  be  read  from  the  card  reader  If  the  numbers  are  changed 
In  the  DATA  statement  to  reflect  the  unit  number  appropriate  to  the  card  reader  on 
the  computer  system  used,  and  If  the  card  files  are  entered  In  the  card  reader  In 
the  sequence  expected  by  the  Loading  Program.  The  sequence  for  reading  files  Is 
shown  In  Table  5-6. 


TABLE  5-6.  File  Reading  Sequence. 


Routine  LOOFIL  expects  Input  files  to  occur  In  the  following  order 


1.  SRCFIL.DAT 

2.  EQPFIL.DAT 

3.  UNRFIL.OAT 

4.  DLFIL.OAT 

5.  LPFIL.DAT 

6.  VEHFIL.DAT 

7.  LD1FIL.DAT 


If  any  files  are  not  to  be  read  In  from  the  card  reader,  unit  numbers  may 
be  left  as  shown  In  the  above  DATA  statement  after  COMNON/FILNUM/  In  file 
PARAM.PRM.  Any  files  to  be  read  from  the  card  reader  must  still  be  Input  In  their 
respective  order  with  the  appropriate  end  of  file  control  cards  placed  between  the 
different  file  decks. 

Notes  on  Data  Files. 

The  files  listed  In  TABLE  5-2  are  briefly  discussed  below. 

EQPFIL.OAT 

This  data  file  Is  read  by  routine  LOOEQP.  The  LIN  number  In  EQPFIL.OAT 

Is  the  first  nine  character  entry  on  each  record.  This  LIN  number  may  have  a 

non-blank  character  In  the  seventh  position,  but  this  character  Is  not  used  by  the 
Loading  Program  and  Is  converted  to  a  blank  for  correct  matching  In  routine 

LOOEQP. 

LDIFIL.OAT 

» 

This  data  file  Is  created  from  LOOl  cards  and  read  by  routine  LOOLOl.  It 
Is  only  used  to  generate  ordinal  numbers  for  the  ANNELOELISTE  report.  It  Is 

Important  to  note  that  routine  ORONO  uses  only  the  first  three  characters  of  the 
character  variable  that  represents  the  vehicle  model  number.  LOIFIL.OAT  contains 
three  or  fewer  non-blank  characters  In  the  vehicle  model  field.  Representative 
examples  of  the  vehicle  model  names  In  LOIFIL.OAT  are  KLS,  SAS,  and  RS.  Routine 
ORONO  uses  only  three  characters  because  VEHFIL.OAT  may  show  a  vehicle  model  of 
KLS  443,  for  example,  and  only  the  first  three  are  meaningful  for  determining 
whether  a  LIN  number  Item  loaded  on  a  vehicle  represents  an  OROINAL  Number.  If  It 
Is  desired  to  define  ordinal  numbers  using  more  than  three  characters  In 
LDIFIL.OAT,  so  that  KLS  443  Is  a  unique  ordinal  number,  the  following  should  be 
done.  The  argument  called  VMOOEL  that  routine  ORONO  receives  should  be  changed 
from  CHARACTER*3  to  CHARACTERn2.  The  variable  called  VMOOEL  In  routine  RPTMIL 
should  be  changed  from  a  CHARACTER*3  to  a  CHARACTER*12.  This  means  that  all 
twelve  characters  of  the  vehicle  model  In  VEHFIL.OAT  must  match  all  twelve 
characters  of  the  vehicle  model  In  LOIFIL.OAT,  or  no  ordinal  number  can  be 
obtained  by  routine  ORONO. 


LPFIL.DAT 


This  file  Is  created  from  the  LOOP  cards  and  read  by  routine  LODLP.  A 
LOOP  card  or  record  must  be  created  for  every  class  that  Is  represented  on  REQ2 
cards,  or  the  Loading  Program  Mill  halt  on  a  subscript  error  when  a  preferred  type 
cannot  be  found  for  an  Item.  If  an  SRC  number  Is  submitted  In  a  unit  move,  the 
Items  will  be  called  class  70,  and  this  class  must  be  provided  for  with  a  LOOP 
card. 

SRCFIL.DAT 

Reading  of  the  SRCFIL  Is  optional.  This  file  Is  used  when  an  SRC  number 
Is  listed  Instead  of  a  LIN  on  an  REQ2  card  for  a  unit  move.  If  no  SRC  numbers  are 
used  for  unit  moves,  then  this  file  should  not  be  read  because  of  Its  large  size 
and  the  resultant  time  consuming  file  reading  operation. 

VEHFIL.DAT 

This  file  Is  read  by  routine  LOOVEH  and  Is  created  from  VEHl  records. 
The  vehicle  types  or  vehicle  sequence  numbers  represented  by  the  IVTYPE  array  In 
file  VEHFIL.PRM  are  read  from  this  file,  correspond  to  the  vehicle  sequence 
numbers  In  LPFIL.OAT,  and  are  represented  by  the  column  numbers  of  the  array 
LOOPRF  In  file  LPFIL.PRM.  Some  Important  notes  about  VEHFIL.DAT  are  Included  In 
the  discussion  of  LDIFIL.OAT.  It  should  be  noted  that  maximum  load  capacity  for 
POL  must  be  gallons  In  thousands  rather  than  NTONS. 

WRMFIL.DAT 

This  file  Is  read  by  routine  LOOWMR  and  has  two  record  formats:  one 
represented  by  the  REQl  card  format,  and  another  represented  by  an  REQ2  card 
format.  The  first  record  will  be  In  REQl  format,  and  the  second  record  will  be 
REq2  format.  The  remaining  records  will  be  a  mixture  of  REQl  and  REQ2  format, 
with  one  and  only  one  REQl  record  followed  by  one  or  more  REQ2  records.  The  east 
REQ2  record  following  an  REQl  record  Is  recognized  by  any  non-blank  character  In 
the  last  position  of  this  eighty  character  record.  If  an  REQ2  Item  has  no  LIN, 
this  field  should  be  left  blank  or  a  LIN  of  some  kind  Is  assumed.  It  should  be 
noted  that  POL  gallons  In  thousands  should  be  entered  In  the  Item  length  field  of 
the  REQ2  card. 


5-4 


AN  INTRODUCTION  TO  EXECUTION  OF  THE  LOADING  PROGRAM. 


The  Loading  Program  be  run  both  Interactively  and  by  batch.  Once  a 
new  file  of  wartime  movement  requests  Is  being  loaded  smoothly  by  the  program.  It 
will  be  desirable  to  run  In  batch  mode.  As  a  new  user  or  when  using  new  files, 
running  the  program  Interactively  will  be  helpful.  Running  the  model 
Interactively  Is  discussed  first  here,  and  a  guide  to  running  In  batch  mode 
follows. 

Interactive  Execution. 

The  VAX  command  'RUN  LOAON'  runs  the  executable  Image  L0ADM.EXE  of  the 
Loading  Program.  The  user  Is  first  given  the  option  to  look  at  current  parameter 
values  to  check  their  compatablllty  with  the  current  files  being  used.  If  the 
parameter  values  are  not  appropriate,  the  user  ma^  exit  the  model  and  change 
parameter  values  In  the  file  PARAM.PRM.  Changing  of  parameter  values  Is  discussed 
In  5-3.2. 


Parameters. 

Parameters  appear  on  the  screen  as  shown  below. 

LOADING  PROGRAM 


DO  YOU  WANT  TO  SEE  PARAMETER  VALUES?  (Y/N)  : 

THESE  ARE  THE  CURRENT  PARAMETER  VALUES  : 


NMOVTS  « 

3 

NUMBER  OF  MOVEMENT/LOAD  TYPES 

UNITS  - 

1 

UNIT  MOVE/LOAD  TYPE 

OVERS  - 

2 

OVERSIZE/OUTSIZE  MOVE/LOAD  TYPE 

OTHER  - 

3 

ALL  OTHER  MOVE/LOAD  TYPES 

NMOOES  - 

5 

NUMBER  OF  MODES 

AIRS  - 

1 

AIR  MODE 

BARGES  « 

2 

BARGE  MODE 

RAILS  « 

3 

RAIL  MODE 

MILHHS  - 

4 

MILITARY  WHEELED  MODE 

CIVMHS  - 

5 

CIVILIAN  WHEELED  MODE 

NBUFS  - 

1 

BUFFERS,  NON-UNIT  AMMO  CONVOYS 

PASMTS  - 

0.8 

PASSENGER  HEIGHT  IN  MTONS 

NCLASS  • 

13 

NUMBER  OF  CLASSES 

RRUT$  >  400.0:  HAX  WT  FOR  RAIL  CONVOY,  MTONS 

RRL6$  -  80.0:  MAX  LENGTH  RAIL  CONVOY,  METERS 

RLAST$  -  1.5:  FACTOR  TIMES  LAST  CAR  WEIGHT 

HIT  RETURN  FOR  MORE  PARAMETERS,  "E"  TO  EXIT,  "S"  TO  START  EXECUTION: 

THESE  ARE  THE  CURRENT  PARAMETER  VALUES: 

NPREFS  >  5  :  PREFERRED  CARRIER  TYPES  ALLOWED  PER  ITEM 

NMVRQS  -  20  :  >  OR  «  #  REQl  CRADS  READ  IN 

NITEMS  «  500  :  >  OR  •  #  OF  REQ2  CARDS  READ  IN 

NAVSH$  -  3  :  AVERAGE  #  OF  SHIPMENTS  FOR  REQl  CARDS 

NDMSLS  «  100  :  >  OR  >  «  OF  LOCI  CARDS  READ  IN 

NLODIS  >  50  :  >  OR  -  #  OF  LODI  CARDS  READ  IN 

NCON$  «  100  :  >  OR  «  NCON,  ARRAY  LIMITS,  CONVOY  ARRAYS 

NELE$  -  700  :  >  OR  «  NELE,  ARRAY  LIMITS,  ELEMNT  ARRAYS 

NITMXS  -  800  :  >  OR  «  NITEMX,  EXPANDED  ITEM  ARRAY  LIMITS 

LPROWS  «  130  :  #  OF  ROWS  IN  LOAD  PREFERENCE  FILE 

LPCOLS  -  99  :  §  OF  COLUMNS  IN  LOAD  PREFERENCE  FILE 

THRLGS  -  0.70  :  USER  DEFINED  LENGTH  UTILIZATION  RATIO 

THRWOS  -  0.70  :  USER  DEFINED  WIDTH  UTILIZATION  RATIO 

THRSTS  -  0.70  :  USER  DEFINED  STACK  UTILIZATION  RATIO 

CLRLG$  «  0.00  :  USER  DEFINED  DOOR  LENGTH  CLEARANCE  MIN 

CLRWOS  >  0.00  :  USER  DEFINED  DOOR  WIDTH  CLEARANCE  MIN 

CLRSTS  -  0.00  :  USER  DEFINED  DOOR  STACK  CLEARANCE  MIN 

HIT  RETURN  FOR  MORE  PARAMETERS,  “E"  TO  EXIT,  "S"  TO  START  EXECUTION: 

THESE  ARE  THE  CURRENT  PARAMETER  VALUES: 

P0L32$  -  50.8  :  CLASS  32,  DIESEL,  1  M3-.840  MTONS 

P0L33$  -  45.0  :  CLASS  33,  MO  GAS,  1  M3-.744  MTONS 

P0L34$  -  48.0  :  CLASS  34,  JP  4,  1  M3>.794  MTONS 

POL35$  -  43.6  :  CLASS  35,  AVN  GAS,  1  M3>.721  MTONS 

NSRC$  >  50  :  >  OR  «  #  SRC  NUMBERS  IN  SRC  TABLE 

NLIN$  >  500  :  >  OR  -  #  LINE  NUMBERS  IN  SRC  TABLE 

NEQP$  «  200  :  >  OR  -  #  LINE  NUMBERS  IN  EQUIP  TABLE 

NLOOIS  -  50  :  >  OR  «  #  LODI  CAROS 

HIT  RETURN  FOR  MORE  PARAMETER,  "E"  TO  EXIT,  "S"  TO  START  EXECUTION: 

LOADING  OPTIMIZATION  WEIGHT  AND  CUBE  PERCENTAGES, 

OPTWTS  «  %  FOR  WEIGHT,  OPTCU$  -  %  FOR  CUBE: 


CONVOY  ELEMENT 
(ROW  1)  (ROW  2) 


0PTWT$(1,AIR$),  0PTHT$(2,AIR$)  - 

0.90 

0.90 

0PTCU${1,AIR$),  0PTCU$(2,AIR$)  - 

0.90 

0.90 

OPTWT$ ( 1 » BARGES ), OPTWT$ ( 2 , BARGES )- 

0.90 

0.90 

0PTCUS(1, BARGES) ,0PTCUS(2,BARGES)- 

0.90 

0.90 

0PTHTS(1.RAILS),0PTUTS(2, RAILS)  - 

0.90 

0.90 

0PTCUS(1,RAILSS),0PTCUS(2, RAILS)  - 

0.90 

0.90 

OPTWTS (1 .MILWH4) ,0PTWTS(2 ,MILHHS )« 

0.90 

0.90 

0PTCUS(1 ,MILWHS) ,0PTCUS(2 ,MILWHS)« 

0.90 

0.90 

0PTWTS(1.CIVWHS),0PTHTS(2,CIVHHS)* 

0.90 

0.90 

0PTCUS(1,CIVHHS),0PTCUS(2,CIVWHS)» 

0.90 

0.90 

HIT  RETURN  FOR  MORE  PARAMETERS,  ”E* 

TO  EXIT, 

"S"  TO  START  EXECUTION: 

100 


ALERT  STAGE  PARAMETERS: 

VSRG  >  MOVEMENT  DAY 
(V)SRG  >  MOVEMENT  DAY  VS 

(VS)RG  «  MOVEMENT  DAY  +  VS  +  SS 
(VSR)G  «  MOVEMENT  DAY  *  n  * 

VS  -  3 
SS  -  3 
RS  -  3 
GS  -11 

HIT  RETURN  FOR  MORE  PARAMETERS,  “E"  TO  EXIT,  "S“  TO  START  EXECUTION 

THESE  ARE  THE  CURRENT  PARAMETER  VALUES, 

CUBE  DEFAULT  TABLE,  HOLDS  CONVERSION  FACTORS  FOR  CUBE 
TO  MTONS,  ONE  FACTOR  FOR  EACH  CLASS,  CLASS  1  FIRST 


CUSS 

1  CUBDEF  (  1) 

S 

2.10 

cuss 

2  CUBOEF  (  2) 

a 

2.60 

cuss 

3  CUBOEF  (  3) 

m 

1.70 

cuss 

4  CUBOEF  (  4) 

9 

2.10 

cuss 

5  CUBDEF  (  5) 

a 

0.90 

cuss 

6  CUBDEF  (  6) 

a 

2.00 

cuss 

7  CUBOEF  (  7) 

a 

2.00 

cuss 

8  CUBDEF  (  8) 

a 

2.60 

cuss 

9  CUBOEF  (  9) 

a 

2.00 

cuss  10  CUBOEF  (10) 

a 

0.00 

cuss  11  CUBDEF  (11) 

a 

0.00 

CUSS  12  CUBOEF  (12) 

a 

0.00 

CUSS  13  CUBOEF  (13) 

a 

0.00 

HIT  RETURN  FOR  MORE  PARAMETERS,  "E"  TO  EXIT.  "S"  TO  START  EXECUTION 


UNIT  NUMBERS  OF  FILES: 


UMRFIL 

(UMRFIL.OAT) 

a 

10 

EQPFIL 

(EQPFIL.DAT) 

a 

11 

OLFIL 

(OLFIL.OAT) 

a 

12 

LOIFIL 

(LDIFIL.OAT) 

a 

13 

LPFIL 

(LPFIL.DAT) 

a 

14 

VEHFIL 

(VEHFIL.DAT) 

a 

15 

SRCFIL 

(SRCFIL.OAT) 

a 

16 

LOADM 

(LOADM.OAT) 

a 

17 

MAX  ELEMENTS/CONVOY  BY  MODE: 
NMAXEL(AIRS)  -  1 

NMAXEL(BARGES)  -  60 

NMAXEL(RAILS)  -  0 

NMAXEL(MILUHS)  -  60 

NMAXa(CIVWHS)  -  60 


**  NO  MORE  PARAMETERS  **  HIT  RETURN  FOR  EXECUTION,  "E"  TO  EXIT 


The  next  option  concerns  reading  file  SRCFIL.DAT.  If  an  SRC  number  has 
been  Included  on  an  REQ2  card  for  a  unit  move,  then  file  SRCFIL.DAT  should  be 
read.  This  Is  a  very  large  file,  and  therefore  should  only  be  read  If  needed. 
Answering  "yes"  sets  the  variable  ISRCRO  In  COMMON/RDSRC/  equal  to  one  which 
causes  routine  LOOFIL  to  call  routine  LODSRC  for  reading  In  file  SRCFIL.DAT.  This 
option  Is  shown  below  as  It  appears  on  the  terminal  screen. 

00  YOU  WANT  TO  READ  THE  SRC  UNIT  FILE?  (Y/N) 

ENTER  ANSWER: 

Final  Report  Generation. 

Three  different  final  reports  are  generated  by  the  Loading  Program.  The 
first  Is  the  AltflELOELlSTE  report,  and  a  representative  sample  can  be  seen  In 
Figure  3-1.  The  second  report  Is  the  Detailed  Load  Plan  which  lists  each  convoy 
and  Its  elements  and  the  Items  that  are  loaded  on  each  element.  The  third  report 
Is  the  TRANATAK  report  which  list  the  MAHLOGS  SHPMT  card  data.  A  fourth  option 
can  be  selected  to  produce  all  three  reports,  and  a  fifth  option  produces  no  final 
reports.  The  choices  appear  on  the  terminal  screen  as  shown  below. 

WHICH  REPORT  FORMS  00  YOU  WANT: 

1.  ANMELOELISTE 

2.  DETAILED  LOAD  PLAN 

3.  TRANATAK  REPORT  AND  SHPMT  CARO  DATA 

4.  ALL  THREE  ABOVE 

5.  NONE 

ENTER  NUMBER: 

TRACE  Statements. 

Many  subroutines  contain  WRITE  statements  which  will  print  contents  of 
variables  to  the  file  L0ADM.DAT.  The  detailed  aspects  of  these  WRITE  statements 
vary,  and  the  value  of  the  variable  KTRACE  1..  COMMON/TRACE/  Is  keyed  to  this 
detail.  The  value  of  KTRACE  Is  set  In  routine  USERIN  when  the  user  selects  the 
trace  option  from  the  below  menu: 


00  YOU  WANT  A  TRACE  OF  THE  LOADING  PROCESS? 

1.  ERROR  REPORT 

2.  ERROR  REPORT,  SUMMARY  LOAD  ARRAYS 

3.  ERROR  REPORT.  SUMMARY  LOAD  ARRAYS,  DETAILED  LOAD  TRACE 

4.  ERROR  REPORT,  DETAILED  LOAD  ARRAYS,  DETAILED  LOAD  TRACE 

5.  FINAL  REPORT  GENERATION  TRACE 

6.  EXIT 
ENTER  NUMBER: 

Option  one  sets  KTRACE  equal  to  1,  and  errors  such  as  parameter  values 
being  too  small  and  file  handling  problems  are  reported.  This  option  must  be 
selected  to  execute  the  model  and  does  not  significantly  Increase  the  size  of  the 
output  file  LOADM.OAT.  If  the  Loading  Program  stops  executing  before  loading  Is 
completed,  these  messages  will  give  a  high  level  recovery  message. 

Option  two  sets  KTRACE  equal  to  2  and  produces  the  final  loading  array 
values  representing  the  REQl  data  arrays,  REQ2  data  arrays,  expanded  REQl  arrays, 
convoy  arrays,  element  arr^s  and  expanded  Item  arrays.  These  arrays  are  further 
explained  In  Appendix  A.  This  option  allows  checking  of  how  the  final  loading 
looks  In  the  actual  arrays  and  does  not  significantly  Increase  the  size  of  the 
output  file  LOADM.OAT. 

Option  three  sets  KTRACE  equal  to  3  and  prints  the  same  final  loading 
array  values  as  option  two  along  with  very  detailed  traces  of  how  each  wartime 
movement  request  Is  loaded  by  the  loading  routines  LODSEQ,  L0AD7,  GBL3D,  LOADP, 
LOAOA,  LOADB,  and  LODPOL.  This  option  significantly  Increases  the  size  of  the 
output  file  LOADM.OAT. 

Option  four  sets  KTRACE  equal  to  4  and  prints  the  same  output  as  option 
three  along  with  the  Intermediate  loading  arrey  values.  This  option  Increases  the 
size  of  the  output  file  LOADM.OAT  the  most  significantly,  and  should  only  be 
chosen  for  very  detailed  debugging  of  the  loading  process.  In  most  debugging 
problems,  option  three  will  be  sufficient  to  solve  the  problem. 

Option  five  sets  KTRACE  equal  to  5  and  prints  a  trace  of  report 
generation  only.  This  provides  Information  necessary  to  debug  any  problems 
evident  In  the  loading  reports.  It  Is  a  separate  option  because  It  Is  generally 
not  desired  unless  final  report  bugs  are  the  only  errors  that  occur. 


REQ1  DATA  ARRAYS 


TWS  MOVBIENT  REOUEST  DATA  RBIAIIIS  SAME  AS  IS 
SEQUENTIALLY  READ  IN  BY  ROUTINE  LOOMHL 


DATA 

DEfiNmow _ 

COLUMN 

ARRAY  THAT 

DATA  IS 

READMTD 

1  ■  NMOVRQ 

ITEMPTR 

POMTS  TO  niBT  REQ2  CARO  IN  REQ2  DATA  ARRAYS 

IPTRI 

FOR  TMSREQl  CARO 

NOVEOAY 

FIRST  nVEMrr  DAY  (REQl  CAROI 

MOVOAY 

NODE 

MODE  OP  MOVEMENT 

MODE 

NOVEPRQ 

MOVeiENT  frequency  (REQl) 

MOVPRQ 

MOVE  COUNT 

TOTAL  COUNT  OF  SMPMENTS  TO  BE  MADE  (REQD 

HOVCT 

SHmN 

DAMSEL  LOCATWMMUMmL  CONVERTED  FROM 

IMMB 

ALPHA  SWPPER  (REQl  CAROL 

RECEIVEN 

DAMgL  LOCATION  NUMBER.  CONVERTED  FROM 

IRCOB 

ALPHA  RECEIVER  (REQl  CARO) 

UMCNIMeER 

LMC  NUHRER  OP  MOVEIENT  REQUEST  (REQU 

UHNM 

HOVE  TYPE 

MOVEMENT/LOAO  TYPE  (REQ2  CARO) 

MOVTYP 

NMOVIIQ 

-  COUNT  OP  REQl  CAROS  READ  IN  BY  LOOBMRROirnNE. 

NMOVRS 

.  USER  OEFINEOPARAMETEISyHMlVRIlEQUAL  TO  ARRAY 

STQRASE  Sn  ASIDE  FOR  REQl  BATAWMAYS. 

REQ2  DATA  ARRAYS 

TINS  ITEIHOVaBIT  REQUEST  DATA  RBNMNS  SANE 
ASSEQDBIT1ALLY  READ  IN  BY  ROUTINE  LOOMR. 

ARRAY  THAT 

DATA 

DATA  IS 

ll'l: 

COLUMN 

1 - ITBi 

^BSSS9Hi 

CLASS 

ICLASS 

URN 

UMI 

MOOB. 

Mooa 

QUANTITY 

ITBIQT 

lEIOHT 

REQZ  CAROS 

inTEM 

CUBE 

CUITEM 

LENGTH 

L6ITEM 

■  ill' 

HEIGHT 

HTITBI 

nACXAGLE 

ISTKBL 

LOAOPTR 

TBPORARY  POINTERS  RM 

iCN  ESTABLISH  LOAD 

IPTRLO 

PRIORITY  BASED  ON  USER  DEPINEO  ATTRIBUTE 

ITEM  - 

CURR6IT  REQZ  ITEM  COLUMN  BEING  LOADED. 

NITEM  - 

COUNT  OP  REQZ  CAROS  READ  IN  BY  LOOMR  ROUTINE. 

NITEMS  " 

USER  OEPMED  PARAMETEIMIITE»,EQUAL  TO  ARRAY 

STORAGE  sn  ASIOE  FOR  REQZ  DATA  ARRAYl 

THESE  MOVEMENT  REQUEST  ARRAYS  CONTAIN  THE 
EXPANDED  REQ1  ARRAYS  ADDITIONAL  MOVBIENT  DAYS  APPROPRIATE  TO 

PERIODIC  MOVEMENTS  AND  ARE  SORTED  BY  ROUTINE 
_ SRTMRO  FOR  LQA0MI6  PRIORITY _ 


DATA 

DEFINITION 

COLUMN 

aRRJSy 

CONTAIMIIO 

DATA 

1 - IMOV— — NNVRQX 

CONVOY  PTR 

POHmTO  FIRST  CONVOY  IN  CONVOY  ARRAYS, 

<0  IF  CONVOY  IS  COMPLETE.  B  VAUO 

IPTRC 

MOVREQPTR 

POMTS  TO  COLUMM  OF  REQl  DATA  ARRAYS 
CONTAMNIM  THIS  MOVEMENTS  ATTIRBUTES 

MRIPTR 

MOVE  DAY 

ACTUAL  DAY  OF  THIS  MOVEMENT 

MQROAY 

RnV-CURREHT  MQVSKMT  BBNQ  LOADED  OUT 

NMVRQX-COUNT  OF  ALL  MOVeenSTO  BE  LOADED  OUT 

NMVRQS«(ISER  OEFINEO PARAHCTEIMIMVRQX,EqUAL  TO  ARRAY 

SrORAOE  SET  AflOC  FOR  EXPANDED  REQl  DATA  ARRAYS 

CONVOY  AHRAYS 

THESE  CONVOY  ARRAYS  CONTAIN  DATA  APPROPRIATE 
TO  EACH  CONVOY  BUH.T 

ARRAY 

DATA 

CONTAHNNB 

OEFINmON  COLUMN 

DATA 

I-  ■■  ■  icon  —  ■  ■iNCOII 


IPTRCE 

TOTWTC 
TDTL6C 

ICON  -  CURRENT/LATEST  CONVOY  REMO  BUILT 

NCON-  TOTAU  NIMNER  OP  CONVOYS  AS  BUILT 

NCONS  -  USER  DEFINED  PARAHCTERMCIMLEqUAL  TO  ARRAY 
STQRAOE  SET  ASIDE  FOR  CONVOY  ARRAYS 


ELEMENT  PTR 

CONVOY  lEIQMT 
CONVOY  LENOTH 


POMTS  TO  FIRST  ELOENT  IN  THIS 
CONVOY^  IF  CONVOY  COMPLETE 


SUMS  BROSS IEI8NT  OF  CONVOY 


SUMS  LBI6TH  OF  CONVOY, 
RAM.  ONLY  _ 
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ELEMENT  ARRAYS 


THESE  ELEMENT  ARRAYS  CONTAIN  DATA  APPROPRIATE 
TO  EACH  ELEMENT  OF  EACH  CONVOY  AS  ELEMENTS 
ARELOAOEOUP. 


ARRAY 

CONTANHNO 

OATA 


1 - lELE  -  - - -  NELE 


OATA 

OEnmnaN  column 


nHSTITEMPTR 

LAST  ITEM  PTR 

CLASS7PTR 
ELEMENT  PTR 

ELEMENT  TYPE 
ELBIENTNQ6HT 

ELOIENTCUBE 


POINTS  TO  nRST  ITEM  (M  THIS  ELEMBIT  IN 
EXPANDED  ITBI  ARRAYS, 

<f  IF  ELEMENT  IS  FULU9M  IF  AMMO 


PONITS  TO  LAST  ITEM  ON  THIS  ELEMENT 
.  -Sm  IF  AMMO 


POUTS  TO  CLASS  7.  LOAD  OATA 


PONin  TO  NEXT  ELBCNT  THIS  CONVOY, 
-1  IS  LAST  ELEMENT  THIS  CONVOY 


ELEMENT  TYPE 


SUMS  NET  REIOHT  OF  ITEMS  LOADED 
ONELBIENT 


SUMS  CUBE  OF  ITEMS  LOADED  ON 


IPTIEI 

IPT2EI 

IPT7B 

IPTREE 

ITYPEL 

tOTNTE 

TOTCUE 


lELE  «  CURRerr/UTEn  ELEMENT  BEBM  LOADED 

NELE  -  TOTAU  NUMBER  OF  ELENENTS  ON  CURRENT/LATEST  CONVOY 


NELES-  USER  OEF1NEO  PARAMETER  EQUAL  TO  ARRAY  STORABE  SET 
ASTOE  FOR  ELBKNT  ARRAYS 


EXPANDED  ITEM  ARRAYS 


THESE  ITBI  ARRAYS  CONTAIN  OATA  APPOPRIATE 
TO  ITBB  AS  LOADED  ON  TO  ELEMBITS 


OATA 


ARRAY 

CONTANNNB 

jm _ 


iTBn- 


•MTEMX 


NEXT  ITEM  PTR 
REQ2PTR 


ITEM  QUANTITY 
/lEiBHT 

ITBCUBE 


POMTS  TO  NEXT  ITEM  TWS  ELBIENT 


PONm  TO  COLUMN  OP  REQEDATA  ARRAYS 
rSATTRII 


CONTAMBM  THIS  ITEM’S^ 


SBUTES 


QUANTITY  LOADED  IF  CLASS  7  OR  PAX 
IEI8HT  LOADED  IF  NOT  CLASS  7  OR  PAX 


CUBE  ITB  LOADED  IF  NOT  CLASS  7 


IXPQT/XPWT 

XPCU 


ITEMX  «  CURRENT/LATEST  COLUMN  OF  ITEM  TO  BE  LOADED 

NITEMX  «  COUNT  OF  TOTAL  ITOM  LOADED 

NITMXS  -  USER  OEFINEDPARAMETERSblNTEMX,EqUAL  TO  ARRAY 
STORAOE  Sn  ASIDE  FOR  EXPANDED  ITEM  ARRAYS 


